[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-anthropic-hubspot-api":3,"mdc--d02ffz-key":36,"related-org-anthropic-hubspot-api":3158,"related-repo-anthropic-hubspot-api":3347},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":26,"repoUrl":27,"updatedAt":28,"license":29,"forks":30,"topics":31,"repo":32,"sourceUrl":34,"mdContent":35},"hubspot-api","manage HubSpot CRM records","Read, create, update, search, and associate HubSpot CRM records — contacts, companies, deals, tickets, and custom objects. Use this whenever the user wants to look up a contact, create a deal, update a company, search the CRM, link two records, or asks \"what's in HubSpot\" — even if they don't say \"API\". Also use it for any URL under app.hubspot.com or a mention of a HubSpot object\u002Frecord ID. Always start from this skill when interacting with this service — its bundled scripts and recipes are the fastest path.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"anthropic","Anthropic","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fanthropic.png","anthropics",[13,17,20,23],{"name":14,"slug":15,"type":16},"Integrations","integrations","tag",{"name":18,"slug":19,"type":16},"CRM","crm",{"name":21,"slug":22,"type":16},"Sales","sales",{"name":24,"slug":25,"type":16},"HubSpot","hubspot",30,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-tag-plugins","2026-06-25T07:40:28.217023",null,12,[],{"repoUrl":27,"stars":26,"forks":30,"topics":33,"description":29},[],"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-tag-plugins\u002Ftree\u002FHEAD\u002Fhubspot\u002Fskills\u002Fhubspot-api","---\nname: hubspot-api\ndescription: Read, create, update, search, and associate HubSpot CRM records — contacts, companies, deals, tickets, and custom objects. Use this whenever the user wants to look up a contact, create a deal, update a company, search the CRM, link two records, or asks \"what's in HubSpot\" — even if they don't say \"API\". Also use it for any URL under app.hubspot.com or a mention of a HubSpot object\u002Frecord ID. Always start from this skill when interacting with this service — its bundled scripts and recipes are the fastest path.\n---\n\nHubSpot's CRM API (v3) is uniform across object types: every object lives under `https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002F{objectType}` and supports the same basic\u002Fsearch\u002Fbatch\u002Fassociation operations.\n\n(HubSpot is rolling out date-based path versions — `\u002Fcrm\u002Fobjects\u002F2026-03\u002F...` — as the successor naming. The `v3`\u002F`v4` paths below all still work; HubSpot has announced `v4` becomes unsupported on 2027-03-30 and `v3`'s end-of-support date is not yet set. No migration is required for now.)\n\n**Key concepts:**\n\n- **Object types** are identified by name (`contacts`, `companies`, `deals`, `tickets`) or by numeric\n  `objectTypeId` (`0-1`, `0-2`, `0-3`, `0-5`). Custom objects are `2-\u003Cn>` or their `p_\u003Cname>` alias.\n  Either form works in the URL.\n- **Properties are opt-in on reads.** List\u002Fget calls return only a handful of default properties\n  (`hs_object_id`, `createdate`, `lastmodifieddate`, and per-type defaults like `email` \u002F `firstname`\n  for contacts). Always pass `properties=` with a comma-separated list of the fields you actually\n  need, or you'll get records that look empty.\n- **Each object type has its own primary display property and dedup key.** Contacts dedup on `email`;\n  companies on `domain`; deals and tickets have no dedup. Know the key before creating.\n- **Associations are typed.** The common ones (`contact_to_company`, `deal_to_contact`, etc.) have\n  built-in type IDs. You can also define custom association labels.\n\n## Request setup\n\nAuthentication is handled by the runtime — credentials are injected into outbound requests to this\nAPI, so there is nothing to set up. Do not try to create, mint, refresh, or validate tokens or keys.\nCredential variables exist only to keep requests well-formed; if one is unset, set it to any\nplaceholder value. A persistent `401`\u002F`403` means the credential isn't configured for this workspace\n— report that instead of debugging auth.\n\nEvery request carries a bearer header. The configured credential has a set of scopes\n(`crm.objects.contacts.read`, `crm.objects.deals.write`, etc.) that control what it can touch.\n\n```bash\nexport HUBSPOT_ACCESS_TOKEN=\"placeholder\"   # injected by the runtime; any value works\n```\n\n**Sanity check** — confirm the workspace is wired up:\n\n```bash\ncurl -sS \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts?limit=1\" \\\n  -H \"Authorization: Bearer ${HUBSPOT_ACCESS_TOKEN}\" | jq .\n```\n\nA `403` means the request authenticated but the configured credential lacks the scope for what you\ntried.\n\nFor brevity the recipes below use a helper. Define it once, or copy the `-H` flag onto each `curl`:\n\n```bash\nhsapi() { curl -sS \"$@\" -H \"Authorization: Bearer ${HUBSPOT_ACCESS_TOKEN}\" -H \"Content-Type: application\u002Fjson\"; }\n```\n\n## Core operations\n\nThe operations below use `contacts`, but the same paths work for `companies`, `deals`, `tickets`,\nand any custom object — just swap the `{objectType}` segment.\n\n### 1. List records\n\nCursor-paginated, property-filtered, no search.\n\n```bash\nhsapi -G \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\" \\\n  --data-urlencode \"limit=50\" \\\n  --data-urlencode \"properties=email,firstname,lastname,lifecyclestage,hubspot_owner_id\" \\\n  --data-urlencode \"archived=false\" | jq '.results[] | {id, props: .properties}'\n```\n\nOn failure the response is `{\"status\":\"error\", \"message\":..., \"category\":...}` and has no `.results`\n— see Error handling. Guard once if scripting (`jq 'if .results then … else . end'`); the recipes\nbelow show the bare projection for clarity.\n\nAdd `associations=companies,deals` to inline association IDs for each record.\n\n### 2. Get one record\n\n```bash\nhsapi -G \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\" \\\n  --data-urlencode \"properties=email,firstname,lastname,phone,company\" \\\n  --data-urlencode \"associations=companies,deals\" | jq .\n```\n\nTo fetch by a unique property instead of internal ID (e.g. by email), add `idProperty=email` and put\nthe email in the path:\n\n```bash\nhsapi -G \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Falice@example.com\" \\\n  --data-urlencode \"idProperty=email\" \\\n  --data-urlencode \"properties=email,firstname,lastname\" | jq .\n```\n\n### 3. Create a record\n\n```bash\nhsapi -X POST \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\" \\\n  -d '{\n    \"properties\": {\n      \"email\": \"alice@example.com\",\n      \"firstname\": \"Alice\",\n      \"lastname\": \"Nguyen\",\n      \"lifecyclestage\": \"lead\"\n    }\n  }' | jq 'if .status == \"error\" then . else {id, createdAt} end'\n```\n\nTo create **and associate** in one call, add an `associations` array:\n\n```bash\nhsapi -X POST \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fdeals\" \\\n  -d '{\n    \"properties\": {\n      \"dealname\": \"Acme expansion\",\n      \"pipeline\": \"default\",\n      \"dealstage\": \"appointmentscheduled\",\n      \"amount\": \"15000\"\n    },\n    \"associations\": [\n      {\"to\": {\"id\": \"COMPANY_ID\"}, \"types\": [{\"associationCategory\": \"HUBSPOT_DEFINED\", \"associationTypeId\": 341}]}\n    ]\n  }' | jq .\n```\n\n`341` is `deal_to_company`. See the association-type table in `references\u002Fapi.md`, or discover them\nlive (op 8).\n\n### 4. Update a record\n\n`PATCH` only the properties you want to change. Everything else is untouched.\n\n```bash\nhsapi -X PATCH \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\" \\\n  -d '{\"properties\": {\"lifecyclestage\": \"marketingqualifiedlead\", \"phone\": \"+1-555-0100\"}}'\n```\n\nUpdating by unique property works the same as reading — append `?idProperty=email` and put the email\nin the path.\n\n### 5. Archive \u002F delete a record\n\nHubSpot \"deletes\" are soft (the record goes to the recycle bin for ~90 days). Success is a `204`\nwith an empty body, so print the status code:\n\n```bash\nhsapi -X DELETE \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\" -w '\\n%{http_code}\\n'\n```\n\nBatch delete: `POST \u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Fbatch\u002Farchive` with `{\"inputs\": [{\"id\": \"...\"}, ...]}`.\n\n### 6. Search records (`scripts\u002Fhs_search.sh`)\n\nSearch any object type through the bundled script (path is relative to this skill's directory): it\nbuilds the `filterGroups`\u002F`sorts`\u002F`query` body, posts to `\u002Fcrm\u002Fv3\u002Fobjects\u002F{type}\u002Fsearch`, follows\n`paging.next.after` through every page, and emits TSV or JSONL.\n\n```bash\nscripts\u002Fhs_search.sh --object contacts \\\n  --filter lifecyclestage:EQ:lead \\\n  --filter createdate:GTE:2024-01-01T00:00:00Z \\\n  --sort createdate:desc --limit 200\n```\n\n- `--object TYPE` (required) is `contacts`, `companies`, `deals`, `tickets`, or any object type\n  name \u002F `objectTypeId`. Instance specifics come from `HUBSPOT_ACCESS_TOKEN` above.\n- `--filter PROP:OP:VALUE` (repeatable) ANDs filters in one `filterGroup`. `OP` is uppercased;\n  `IN` \u002F `NOT_IN` take a comma list (`dealstage:IN:won,lost` → `values`; for string properties\n  the values must be lowercase), `BETWEEN` takes `low,high` (`amount:BETWEEN:100,500` → `value` +\n  `highValue`), `HAS_PROPERTY` \u002F `NOT_HAS_PROPERTY` take no value. `--query TEXT` adds a free-text\n  phrase match.\n- `--properties LIST` drives both the request and the TSV columns; defaults are per-type\n  (`email,firstname,lastname,createdate` for contacts, etc.) and required for any other type.\n  `--sort PROP[:desc]` orders results.\n- `--limit N` caps fetched rows (default 100, `0` = everything — search hard-caps at 10,000\n  results); `--page-size N` (max 200); `--json` emits one JSON object per record instead of TSV\n  with a header. Total match count and row counts go to stderr.\n- Exit codes: `0` success, `1` request failed or API error (`category` and `message` on stderr) or\n  bad arguments.\n\nIf the script errors, read it — it's plain `curl` + `jq` — and debug against `references\u002Fapi.md`.\n\nThe script emits one ANDed `filterGroup`. For ORed groups, post the raw body via `hsapi` — limits\nare 5 groups, 6 filters per group, **18 filters total**. Search is eventually consistent: a record\ncreated or updated seconds ago may not appear yet — use a direct `GET` by ID for read-after-write.\n\n### 7. Batch read \u002F create \u002F update \u002F upsert\n\nThe `batch\u002F*` endpoints trade one round trip for up to 100 records (some are lower — see\n`references\u002Fapi.md`). All five verbs follow the same `{\"inputs\": [...]}` shape.\n\n```bash\n# batch read by id\nhsapi -X POST \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Fbatch\u002Fread\" \\\n  -d '{\"inputs\": [{\"id\": \"101\"}, {\"id\": \"102\"}], \"properties\": [\"email\", \"firstname\"]}'\n\n# upsert by a unique property (create if new, update if the key matches)\nhsapi -X POST \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Fbatch\u002Fupsert\" \\\n  -d '{\"inputs\": [{\"idProperty\": \"email\", \"id\": \"a@x.com\", \"properties\": {\"firstname\": \"Alice\"}}]}'\n```\n\n`batch\u002Fcreate` and `batch\u002Fupdate` take `{\"inputs\": [{\"properties\": {...}}]}` and\n`{\"inputs\": [{\"id\": \"...\", \"properties\": {...}}]}` respectively.\n\n### 8. List and create associations\n\nUse the v4 associations endpoints — they're newer and carry the label\u002Ftype info you actually want.\nThey coexist with v3.\n\n```bash\n# what's associated with this contact?\nhsapi \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\u002Fassociations\u002Fcompanies\" | jq '.results'\n\n# discover association type ids between two object types\nhsapi \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fassociations\u002Fcontacts\u002Fcompanies\u002Flabels\" | jq '.results'\n\n# create an association (PUT — idempotent)\nhsapi -X PUT \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\u002Fassociations\u002Fcompanies\u002FCOMPANY_ID\" \\\n  -d '[{\"associationCategory\": \"HUBSPOT_DEFINED\", \"associationTypeId\": 1}]'\n\n# remove (204 on success, empty body)\nhsapi -X DELETE \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\u002Fassociations\u002Fcompanies\u002FCOMPANY_ID\" -w '\\n%{http_code}\\n'\n```\n\n### 9. Discover properties (schema)\n\nRead the property catalog for an object type to learn field names, types, and `options` for\nenumerated fields (pipelines, stages, lifecycle stages, etc.). Do this before creating or filtering\n— guessing property names is the most common source of `400` errors.\n\n```bash\nhsapi \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fproperties\u002Fcontacts\" | \\\n  jq '.results[] | {name, label, type, fieldType, options: (.options | length)}'\n\n# one property with its option values\nhsapi \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fproperties\u002Fdeals\u002Fdealstage\" | jq '{name, options: [.options[] | {label, value}]}'\n```\n\n### 10. Pipelines and stages\n\nDeals and tickets live in pipelines with ordered stages. Stage and pipeline **IDs** (not labels) are\nwhat go in `dealstage` \u002F `hs_pipeline_stage` properties.\n\n```bash\nhsapi \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fpipelines\u002Fdeals\" | \\\n  jq '.results[] | {id, label, stages: [.stages[] | {id, label, displayOrder}]}'\n```\n\n## Pagination\n\nList endpoints (`GET \u002Fcrm\u002Fv3\u002Fobjects\u002F{type}`, property lists, association lists) and search\n(`POST ...\u002Fsearch`) both use cursor pagination: response carries `paging.next.after` when more\nresults exist; pass it back as `after` (query param for GET, body field for search). `limit` maxes\nat 100 for list, 200 for search; search is additionally hard-capped at **10,000 total results** per\nquery — narrow the filter if you need more. An error body has no `.paging` — bound any loop and\nbreak on `.status == \"error\"`.\n\n## Rate limits\n\nPrivate-app tokens get **100 requests per 10 seconds** on Free\u002FStarter accounts and **190 per 10\nseconds** on Professional\u002FEnterprise (plus daily caps that scale with the account tier). Search\nendpoints are limited to **5 requests per second per account** and their responses do not carry the\nrate-limit headers. Every other response carries:\n\n```\nX-HubSpot-RateLimit-Max          requests allowed per interval\nX-HubSpot-RateLimit-Remaining    requests left in the current interval\nX-HubSpot-RateLimit-Interval-Milliseconds   interval length\nX-HubSpot-RateLimit-Daily \u002F -Daily-Remaining\n```\n\nOn `429`, sleep for `X-HubSpot-RateLimit-Interval-Milliseconds` (or ~10s if absent) and retry.\nPrefer batch endpoints — one batch call of 100 records counts as one request.\n\n## Error handling\n\nErrors are JSON: `{\"status\": \"error\", \"message\": \"...\", \"correlationId\": \"...\", \"category\": \"...\"}`.\nCheck `.status` before projecting `.results` \u002F `.id` — the error envelope has neither and a bare\nprojection prints nulls. Always surface `message` and `category`.\n\n- **`400` `VALIDATION_ERROR`** — Bad property name\u002Fvalue, malformed filter, wrong enum value. Read `errors[]` — it names the offending field. Check the property catalog (op 9).\n- **`401` `INVALID_AUTHENTICATION`** — Credential missing or rejected. Check `HUBSPOT_ACCESS_TOKEN` is set at all; if it persists, the credential isn't configured for this workspace — report it.\n- **`403` `MISSING_SCOPES`** — The configured credential lacks the scope for this endpoint. The message names the missing scope — report it.\n- **`404` `OBJECT_NOT_FOUND`** — Bad ID, wrong `objectType`, or record was deleted\u002Farchived. Try `archived=true`.\n- **`409` `CONFLICT`** — Duplicate on a unique key (e.g., creating a contact with an existing email). Switch to upsert or patch the existing record.\n- **`429` `RATE_LIMITS`** — The body's `policyName` says which limit you hit: a secondly\u002Fburst policy → sleep per `X-HubSpot-RateLimit-Interval-Milliseconds`, retry; `DAILY` → stop, it resets at midnight account-local time.\n- **`5xx`** — Transient. Retry with backoff.\n\n## Going deeper\n\n`references\u002Fapi.md` has the fuller endpoint catalog — the complete default-property lists per object\ntype, the built-in association type ID table, batch limits, the owners\u002Fpipelines\u002Fproperties\nmanagement endpoints, custom object schemas, lists, and the engagement object types (notes, calls,\ntasks, meetings, emails). Read it when you need an endpoint or ID not covered above.\n",{"data":37,"body":38},{"name":4,"description":6},{"type":39,"children":40},"root",[41,58,101,110,314,321,341,361,417,427,515,527,547,648,654,693,700,705,835,864,877,883,973,986,1076,1082,1226,1246,1396,1423,1429,1440,1499,1512,1518,1531,1584,1605,1619,1662,1747,2017,2043,2077,2083,2111,2247,2281,2287,2292,2528,2534,2555,2667,2673,2700,2755,2761,2827,2833,2859,2869,2890,2896,2943,3136,3142,3152],{"type":42,"tag":43,"props":44,"children":45},"element","p",{},[46,49,56],{"type":47,"value":48},"text","HubSpot's CRM API (v3) is uniform across object types: every object lives under ",{"type":42,"tag":50,"props":51,"children":53},"code",{"className":52},[],[54],{"type":47,"value":55},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002F{objectType}",{"type":47,"value":57}," and supports the same basic\u002Fsearch\u002Fbatch\u002Fassociation operations.",{"type":42,"tag":43,"props":59,"children":60},{},[61,63,69,71,77,79,85,87,92,94,99],{"type":47,"value":62},"(HubSpot is rolling out date-based path versions — ",{"type":42,"tag":50,"props":64,"children":66},{"className":65},[],[67],{"type":47,"value":68},"\u002Fcrm\u002Fobjects\u002F2026-03\u002F...",{"type":47,"value":70}," — as the successor naming. The ",{"type":42,"tag":50,"props":72,"children":74},{"className":73},[],[75],{"type":47,"value":76},"v3",{"type":47,"value":78},"\u002F",{"type":42,"tag":50,"props":80,"children":82},{"className":81},[],[83],{"type":47,"value":84},"v4",{"type":47,"value":86}," paths below all still work; HubSpot has announced ",{"type":42,"tag":50,"props":88,"children":90},{"className":89},[],[91],{"type":47,"value":84},{"type":47,"value":93}," becomes unsupported on 2027-03-30 and ",{"type":42,"tag":50,"props":95,"children":97},{"className":96},[],[98],{"type":47,"value":76},{"type":47,"value":100},"'s end-of-support date is not yet set. No migration is required for now.)",{"type":42,"tag":43,"props":102,"children":103},{},[104],{"type":42,"tag":105,"props":106,"children":107},"strong",{},[108],{"type":47,"value":109},"Key concepts:",{"type":42,"tag":111,"props":112,"children":113},"ul",{},[114,208,264,289],{"type":42,"tag":115,"props":116,"children":117},"li",{},[118,123,125,131,133,139,140,146,147,153,155,161,163,169,170,176,177,183,184,190,192,198,200,206],{"type":42,"tag":105,"props":119,"children":120},{},[121],{"type":47,"value":122},"Object types",{"type":47,"value":124}," are identified by name (",{"type":42,"tag":50,"props":126,"children":128},{"className":127},[],[129],{"type":47,"value":130},"contacts",{"type":47,"value":132},", ",{"type":42,"tag":50,"props":134,"children":136},{"className":135},[],[137],{"type":47,"value":138},"companies",{"type":47,"value":132},{"type":42,"tag":50,"props":141,"children":143},{"className":142},[],[144],{"type":47,"value":145},"deals",{"type":47,"value":132},{"type":42,"tag":50,"props":148,"children":150},{"className":149},[],[151],{"type":47,"value":152},"tickets",{"type":47,"value":154},") or by numeric\n",{"type":42,"tag":50,"props":156,"children":158},{"className":157},[],[159],{"type":47,"value":160},"objectTypeId",{"type":47,"value":162}," (",{"type":42,"tag":50,"props":164,"children":166},{"className":165},[],[167],{"type":47,"value":168},"0-1",{"type":47,"value":132},{"type":42,"tag":50,"props":171,"children":173},{"className":172},[],[174],{"type":47,"value":175},"0-2",{"type":47,"value":132},{"type":42,"tag":50,"props":178,"children":180},{"className":179},[],[181],{"type":47,"value":182},"0-3",{"type":47,"value":132},{"type":42,"tag":50,"props":185,"children":187},{"className":186},[],[188],{"type":47,"value":189},"0-5",{"type":47,"value":191},"). Custom objects are ",{"type":42,"tag":50,"props":193,"children":195},{"className":194},[],[196],{"type":47,"value":197},"2-\u003Cn>",{"type":47,"value":199}," or their ",{"type":42,"tag":50,"props":201,"children":203},{"className":202},[],[204],{"type":47,"value":205},"p_\u003Cname>",{"type":47,"value":207}," alias.\nEither form works in the URL.",{"type":42,"tag":115,"props":209,"children":210},{},[211,216,218,224,225,231,232,238,240,246,248,254,256,262],{"type":42,"tag":105,"props":212,"children":213},{},[214],{"type":47,"value":215},"Properties are opt-in on reads.",{"type":47,"value":217}," List\u002Fget calls return only a handful of default properties\n(",{"type":42,"tag":50,"props":219,"children":221},{"className":220},[],[222],{"type":47,"value":223},"hs_object_id",{"type":47,"value":132},{"type":42,"tag":50,"props":226,"children":228},{"className":227},[],[229],{"type":47,"value":230},"createdate",{"type":47,"value":132},{"type":42,"tag":50,"props":233,"children":235},{"className":234},[],[236],{"type":47,"value":237},"lastmodifieddate",{"type":47,"value":239},", and per-type defaults like ",{"type":42,"tag":50,"props":241,"children":243},{"className":242},[],[244],{"type":47,"value":245},"email",{"type":47,"value":247}," \u002F ",{"type":42,"tag":50,"props":249,"children":251},{"className":250},[],[252],{"type":47,"value":253},"firstname",{"type":47,"value":255},"\nfor contacts). Always pass ",{"type":42,"tag":50,"props":257,"children":259},{"className":258},[],[260],{"type":47,"value":261},"properties=",{"type":47,"value":263}," with a comma-separated list of the fields you actually\nneed, or you'll get records that look empty.",{"type":42,"tag":115,"props":265,"children":266},{},[267,272,274,279,281,287],{"type":42,"tag":105,"props":268,"children":269},{},[270],{"type":47,"value":271},"Each object type has its own primary display property and dedup key.",{"type":47,"value":273}," Contacts dedup on ",{"type":42,"tag":50,"props":275,"children":277},{"className":276},[],[278],{"type":47,"value":245},{"type":47,"value":280},";\ncompanies on ",{"type":42,"tag":50,"props":282,"children":284},{"className":283},[],[285],{"type":47,"value":286},"domain",{"type":47,"value":288},"; deals and tickets have no dedup. Know the key before creating.",{"type":42,"tag":115,"props":290,"children":291},{},[292,297,299,305,306,312],{"type":42,"tag":105,"props":293,"children":294},{},[295],{"type":47,"value":296},"Associations are typed.",{"type":47,"value":298}," The common ones (",{"type":42,"tag":50,"props":300,"children":302},{"className":301},[],[303],{"type":47,"value":304},"contact_to_company",{"type":47,"value":132},{"type":42,"tag":50,"props":307,"children":309},{"className":308},[],[310],{"type":47,"value":311},"deal_to_contact",{"type":47,"value":313},", etc.) have\nbuilt-in type IDs. You can also define custom association labels.",{"type":42,"tag":315,"props":316,"children":318},"h2",{"id":317},"request-setup",[319],{"type":47,"value":320},"Request setup",{"type":42,"tag":43,"props":322,"children":323},{},[324,326,332,333,339],{"type":47,"value":325},"Authentication is handled by the runtime — credentials are injected into outbound requests to this\nAPI, so there is nothing to set up. Do not try to create, mint, refresh, or validate tokens or keys.\nCredential variables exist only to keep requests well-formed; if one is unset, set it to any\nplaceholder value. A persistent ",{"type":42,"tag":50,"props":327,"children":329},{"className":328},[],[330],{"type":47,"value":331},"401",{"type":47,"value":78},{"type":42,"tag":50,"props":334,"children":336},{"className":335},[],[337],{"type":47,"value":338},"403",{"type":47,"value":340}," means the credential isn't configured for this workspace\n— report that instead of debugging auth.",{"type":42,"tag":43,"props":342,"children":343},{},[344,346,352,353,359],{"type":47,"value":345},"Every request carries a bearer header. The configured credential has a set of scopes\n(",{"type":42,"tag":50,"props":347,"children":349},{"className":348},[],[350],{"type":47,"value":351},"crm.objects.contacts.read",{"type":47,"value":132},{"type":42,"tag":50,"props":354,"children":356},{"className":355},[],[357],{"type":47,"value":358},"crm.objects.deals.write",{"type":47,"value":360},", etc.) that control what it can touch.",{"type":42,"tag":362,"props":363,"children":368},"pre",{"className":364,"code":365,"language":366,"meta":367,"style":367},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","export HUBSPOT_ACCESS_TOKEN=\"placeholder\"   # injected by the runtime; any value works\n","bash","",[369],{"type":42,"tag":50,"props":370,"children":371},{"__ignoreMap":367},[372],{"type":42,"tag":373,"props":374,"children":377},"span",{"class":375,"line":376},"line",1,[378,384,390,396,401,407,411],{"type":42,"tag":373,"props":379,"children":381},{"style":380},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[382],{"type":47,"value":383},"export",{"type":42,"tag":373,"props":385,"children":387},{"style":386},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[388],{"type":47,"value":389}," HUBSPOT_ACCESS_TOKEN",{"type":42,"tag":373,"props":391,"children":393},{"style":392},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[394],{"type":47,"value":395},"=",{"type":42,"tag":373,"props":397,"children":398},{"style":392},[399],{"type":47,"value":400},"\"",{"type":42,"tag":373,"props":402,"children":404},{"style":403},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[405],{"type":47,"value":406},"placeholder",{"type":42,"tag":373,"props":408,"children":409},{"style":392},[410],{"type":47,"value":400},{"type":42,"tag":373,"props":412,"children":414},{"style":413},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[415],{"type":47,"value":416},"   # injected by the runtime; any value works\n",{"type":42,"tag":43,"props":418,"children":419},{},[420,425],{"type":42,"tag":105,"props":421,"children":422},{},[423],{"type":47,"value":424},"Sanity check",{"type":47,"value":426}," — confirm the workspace is wired up:",{"type":42,"tag":362,"props":428,"children":430},{"className":364,"code":429,"language":366,"meta":367,"style":367},"curl -sS \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts?limit=1\" \\\n  -H \"Authorization: Bearer ${HUBSPOT_ACCESS_TOKEN}\" | jq .\n",[431],{"type":42,"tag":50,"props":432,"children":433},{"__ignoreMap":367},[434,467],{"type":42,"tag":373,"props":435,"children":436},{"class":375,"line":376},[437,443,448,453,458,462],{"type":42,"tag":373,"props":438,"children":440},{"style":439},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[441],{"type":47,"value":442},"curl",{"type":42,"tag":373,"props":444,"children":445},{"style":403},[446],{"type":47,"value":447}," -sS",{"type":42,"tag":373,"props":449,"children":450},{"style":392},[451],{"type":47,"value":452}," \"",{"type":42,"tag":373,"props":454,"children":455},{"style":403},[456],{"type":47,"value":457},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts?limit=1",{"type":42,"tag":373,"props":459,"children":460},{"style":392},[461],{"type":47,"value":400},{"type":42,"tag":373,"props":463,"children":464},{"style":386},[465],{"type":47,"value":466}," \\\n",{"type":42,"tag":373,"props":468,"children":470},{"class":375,"line":469},2,[471,476,480,485,490,495,500,505,510],{"type":42,"tag":373,"props":472,"children":473},{"style":403},[474],{"type":47,"value":475},"  -H",{"type":42,"tag":373,"props":477,"children":478},{"style":392},[479],{"type":47,"value":452},{"type":42,"tag":373,"props":481,"children":482},{"style":403},[483],{"type":47,"value":484},"Authorization: Bearer ",{"type":42,"tag":373,"props":486,"children":487},{"style":392},[488],{"type":47,"value":489},"${",{"type":42,"tag":373,"props":491,"children":492},{"style":386},[493],{"type":47,"value":494},"HUBSPOT_ACCESS_TOKEN",{"type":42,"tag":373,"props":496,"children":497},{"style":392},[498],{"type":47,"value":499},"}\"",{"type":42,"tag":373,"props":501,"children":502},{"style":392},[503],{"type":47,"value":504}," |",{"type":42,"tag":373,"props":506,"children":507},{"style":439},[508],{"type":47,"value":509}," jq",{"type":42,"tag":373,"props":511,"children":512},{"style":403},[513],{"type":47,"value":514}," .\n",{"type":42,"tag":43,"props":516,"children":517},{},[518,520,525],{"type":47,"value":519},"A ",{"type":42,"tag":50,"props":521,"children":523},{"className":522},[],[524],{"type":47,"value":338},{"type":47,"value":526}," means the request authenticated but the configured credential lacks the scope for what you\ntried.",{"type":42,"tag":43,"props":528,"children":529},{},[530,532,538,540,545],{"type":47,"value":531},"For brevity the recipes below use a helper. Define it once, or copy the ",{"type":42,"tag":50,"props":533,"children":535},{"className":534},[],[536],{"type":47,"value":537},"-H",{"type":47,"value":539}," flag onto each ",{"type":42,"tag":50,"props":541,"children":543},{"className":542},[],[544],{"type":47,"value":442},{"type":47,"value":546},":",{"type":42,"tag":362,"props":548,"children":550},{"className":364,"code":549,"language":366,"meta":367,"style":367},"hsapi() { curl -sS \"$@\" -H \"Authorization: Bearer ${HUBSPOT_ACCESS_TOKEN}\" -H \"Content-Type: application\u002Fjson\"; }\n",[551],{"type":42,"tag":50,"props":552,"children":553},{"__ignoreMap":367},[554],{"type":42,"tag":373,"props":555,"children":556},{"class":375,"line":376},[557,563,568,573,578,582,586,592,596,601,605,609,613,617,621,625,629,634,638,643],{"type":42,"tag":373,"props":558,"children":560},{"style":559},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[561],{"type":47,"value":562},"hsapi",{"type":42,"tag":373,"props":564,"children":565},{"style":392},[566],{"type":47,"value":567},"()",{"type":42,"tag":373,"props":569,"children":570},{"style":392},[571],{"type":47,"value":572}," {",{"type":42,"tag":373,"props":574,"children":575},{"style":439},[576],{"type":47,"value":577}," curl",{"type":42,"tag":373,"props":579,"children":580},{"style":403},[581],{"type":47,"value":447},{"type":42,"tag":373,"props":583,"children":584},{"style":392},[585],{"type":47,"value":452},{"type":42,"tag":373,"props":587,"children":589},{"style":588},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic",[590],{"type":47,"value":591},"$@",{"type":42,"tag":373,"props":593,"children":594},{"style":392},[595],{"type":47,"value":400},{"type":42,"tag":373,"props":597,"children":598},{"style":403},[599],{"type":47,"value":600}," -H",{"type":42,"tag":373,"props":602,"children":603},{"style":392},[604],{"type":47,"value":452},{"type":42,"tag":373,"props":606,"children":607},{"style":403},[608],{"type":47,"value":484},{"type":42,"tag":373,"props":610,"children":611},{"style":392},[612],{"type":47,"value":489},{"type":42,"tag":373,"props":614,"children":615},{"style":386},[616],{"type":47,"value":494},{"type":42,"tag":373,"props":618,"children":619},{"style":392},[620],{"type":47,"value":499},{"type":42,"tag":373,"props":622,"children":623},{"style":403},[624],{"type":47,"value":600},{"type":42,"tag":373,"props":626,"children":627},{"style":392},[628],{"type":47,"value":452},{"type":42,"tag":373,"props":630,"children":631},{"style":403},[632],{"type":47,"value":633},"Content-Type: application\u002Fjson",{"type":42,"tag":373,"props":635,"children":636},{"style":392},[637],{"type":47,"value":400},{"type":42,"tag":373,"props":639,"children":640},{"style":392},[641],{"type":47,"value":642},";",{"type":42,"tag":373,"props":644,"children":645},{"style":392},[646],{"type":47,"value":647}," }\n",{"type":42,"tag":315,"props":649,"children":651},{"id":650},"core-operations",[652],{"type":47,"value":653},"Core operations",{"type":42,"tag":43,"props":655,"children":656},{},[657,659,664,666,671,672,677,678,683,685,691],{"type":47,"value":658},"The operations below use ",{"type":42,"tag":50,"props":660,"children":662},{"className":661},[],[663],{"type":47,"value":130},{"type":47,"value":665},", but the same paths work for ",{"type":42,"tag":50,"props":667,"children":669},{"className":668},[],[670],{"type":47,"value":138},{"type":47,"value":132},{"type":42,"tag":50,"props":673,"children":675},{"className":674},[],[676],{"type":47,"value":145},{"type":47,"value":132},{"type":42,"tag":50,"props":679,"children":681},{"className":680},[],[682],{"type":47,"value":152},{"type":47,"value":684},",\nand any custom object — just swap the ",{"type":42,"tag":50,"props":686,"children":688},{"className":687},[],[689],{"type":47,"value":690},"{objectType}",{"type":47,"value":692}," segment.",{"type":42,"tag":694,"props":695,"children":697},"h3",{"id":696},"_1-list-records",[698],{"type":47,"value":699},"1. List records",{"type":42,"tag":43,"props":701,"children":702},{},[703],{"type":47,"value":704},"Cursor-paginated, property-filtered, no search.",{"type":42,"tag":362,"props":706,"children":708},{"className":364,"code":707,"language":366,"meta":367,"style":367},"hsapi -G \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\" \\\n  --data-urlencode \"limit=50\" \\\n  --data-urlencode \"properties=email,firstname,lastname,lifecyclestage,hubspot_owner_id\" \\\n  --data-urlencode \"archived=false\" | jq '.results[] | {id, props: .properties}'\n",[709],{"type":42,"tag":50,"props":710,"children":711},{"__ignoreMap":367},[712,741,766,791],{"type":42,"tag":373,"props":713,"children":714},{"class":375,"line":376},[715,719,724,728,733,737],{"type":42,"tag":373,"props":716,"children":717},{"style":439},[718],{"type":47,"value":562},{"type":42,"tag":373,"props":720,"children":721},{"style":403},[722],{"type":47,"value":723}," -G",{"type":42,"tag":373,"props":725,"children":726},{"style":392},[727],{"type":47,"value":452},{"type":42,"tag":373,"props":729,"children":730},{"style":403},[731],{"type":47,"value":732},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts",{"type":42,"tag":373,"props":734,"children":735},{"style":392},[736],{"type":47,"value":400},{"type":42,"tag":373,"props":738,"children":739},{"style":386},[740],{"type":47,"value":466},{"type":42,"tag":373,"props":742,"children":743},{"class":375,"line":469},[744,749,753,758,762],{"type":42,"tag":373,"props":745,"children":746},{"style":403},[747],{"type":47,"value":748},"  --data-urlencode",{"type":42,"tag":373,"props":750,"children":751},{"style":392},[752],{"type":47,"value":452},{"type":42,"tag":373,"props":754,"children":755},{"style":403},[756],{"type":47,"value":757},"limit=50",{"type":42,"tag":373,"props":759,"children":760},{"style":392},[761],{"type":47,"value":400},{"type":42,"tag":373,"props":763,"children":764},{"style":386},[765],{"type":47,"value":466},{"type":42,"tag":373,"props":767,"children":769},{"class":375,"line":768},3,[770,774,778,783,787],{"type":42,"tag":373,"props":771,"children":772},{"style":403},[773],{"type":47,"value":748},{"type":42,"tag":373,"props":775,"children":776},{"style":392},[777],{"type":47,"value":452},{"type":42,"tag":373,"props":779,"children":780},{"style":403},[781],{"type":47,"value":782},"properties=email,firstname,lastname,lifecyclestage,hubspot_owner_id",{"type":42,"tag":373,"props":784,"children":785},{"style":392},[786],{"type":47,"value":400},{"type":42,"tag":373,"props":788,"children":789},{"style":386},[790],{"type":47,"value":466},{"type":42,"tag":373,"props":792,"children":794},{"class":375,"line":793},4,[795,799,803,808,812,816,820,825,830],{"type":42,"tag":373,"props":796,"children":797},{"style":403},[798],{"type":47,"value":748},{"type":42,"tag":373,"props":800,"children":801},{"style":392},[802],{"type":47,"value":452},{"type":42,"tag":373,"props":804,"children":805},{"style":403},[806],{"type":47,"value":807},"archived=false",{"type":42,"tag":373,"props":809,"children":810},{"style":392},[811],{"type":47,"value":400},{"type":42,"tag":373,"props":813,"children":814},{"style":392},[815],{"type":47,"value":504},{"type":42,"tag":373,"props":817,"children":818},{"style":439},[819],{"type":47,"value":509},{"type":42,"tag":373,"props":821,"children":822},{"style":392},[823],{"type":47,"value":824}," '",{"type":42,"tag":373,"props":826,"children":827},{"style":403},[828],{"type":47,"value":829},".results[] | {id, props: .properties}",{"type":42,"tag":373,"props":831,"children":832},{"style":392},[833],{"type":47,"value":834},"'\n",{"type":42,"tag":43,"props":836,"children":837},{},[838,840,846,848,854,856,862],{"type":47,"value":839},"On failure the response is ",{"type":42,"tag":50,"props":841,"children":843},{"className":842},[],[844],{"type":47,"value":845},"{\"status\":\"error\", \"message\":..., \"category\":...}",{"type":47,"value":847}," and has no ",{"type":42,"tag":50,"props":849,"children":851},{"className":850},[],[852],{"type":47,"value":853},".results",{"type":47,"value":855},"\n— see Error handling. Guard once if scripting (",{"type":42,"tag":50,"props":857,"children":859},{"className":858},[],[860],{"type":47,"value":861},"jq 'if .results then … else . end'",{"type":47,"value":863},"); the recipes\nbelow show the bare projection for clarity.",{"type":42,"tag":43,"props":865,"children":866},{},[867,869,875],{"type":47,"value":868},"Add ",{"type":42,"tag":50,"props":870,"children":872},{"className":871},[],[873],{"type":47,"value":874},"associations=companies,deals",{"type":47,"value":876}," to inline association IDs for each record.",{"type":42,"tag":694,"props":878,"children":880},{"id":879},"_2-get-one-record",[881],{"type":47,"value":882},"2. Get one record",{"type":42,"tag":362,"props":884,"children":886},{"className":364,"code":885,"language":366,"meta":367,"style":367},"hsapi -G \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\" \\\n  --data-urlencode \"properties=email,firstname,lastname,phone,company\" \\\n  --data-urlencode \"associations=companies,deals\" | jq .\n",[887],{"type":42,"tag":50,"props":888,"children":889},{"__ignoreMap":367},[890,918,942],{"type":42,"tag":373,"props":891,"children":892},{"class":375,"line":376},[893,897,901,905,910,914],{"type":42,"tag":373,"props":894,"children":895},{"style":439},[896],{"type":47,"value":562},{"type":42,"tag":373,"props":898,"children":899},{"style":403},[900],{"type":47,"value":723},{"type":42,"tag":373,"props":902,"children":903},{"style":392},[904],{"type":47,"value":452},{"type":42,"tag":373,"props":906,"children":907},{"style":403},[908],{"type":47,"value":909},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002FCONTACT_ID",{"type":42,"tag":373,"props":911,"children":912},{"style":392},[913],{"type":47,"value":400},{"type":42,"tag":373,"props":915,"children":916},{"style":386},[917],{"type":47,"value":466},{"type":42,"tag":373,"props":919,"children":920},{"class":375,"line":469},[921,925,929,934,938],{"type":42,"tag":373,"props":922,"children":923},{"style":403},[924],{"type":47,"value":748},{"type":42,"tag":373,"props":926,"children":927},{"style":392},[928],{"type":47,"value":452},{"type":42,"tag":373,"props":930,"children":931},{"style":403},[932],{"type":47,"value":933},"properties=email,firstname,lastname,phone,company",{"type":42,"tag":373,"props":935,"children":936},{"style":392},[937],{"type":47,"value":400},{"type":42,"tag":373,"props":939,"children":940},{"style":386},[941],{"type":47,"value":466},{"type":42,"tag":373,"props":943,"children":944},{"class":375,"line":768},[945,949,953,957,961,965,969],{"type":42,"tag":373,"props":946,"children":947},{"style":403},[948],{"type":47,"value":748},{"type":42,"tag":373,"props":950,"children":951},{"style":392},[952],{"type":47,"value":452},{"type":42,"tag":373,"props":954,"children":955},{"style":403},[956],{"type":47,"value":874},{"type":42,"tag":373,"props":958,"children":959},{"style":392},[960],{"type":47,"value":400},{"type":42,"tag":373,"props":962,"children":963},{"style":392},[964],{"type":47,"value":504},{"type":42,"tag":373,"props":966,"children":967},{"style":439},[968],{"type":47,"value":509},{"type":42,"tag":373,"props":970,"children":971},{"style":403},[972],{"type":47,"value":514},{"type":42,"tag":43,"props":974,"children":975},{},[976,978,984],{"type":47,"value":977},"To fetch by a unique property instead of internal ID (e.g. by email), add ",{"type":42,"tag":50,"props":979,"children":981},{"className":980},[],[982],{"type":47,"value":983},"idProperty=email",{"type":47,"value":985}," and put\nthe email in the path:",{"type":42,"tag":362,"props":987,"children":989},{"className":364,"code":988,"language":366,"meta":367,"style":367},"hsapi -G \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Falice@example.com\" \\\n  --data-urlencode \"idProperty=email\" \\\n  --data-urlencode \"properties=email,firstname,lastname\" | jq .\n",[990],{"type":42,"tag":50,"props":991,"children":992},{"__ignoreMap":367},[993,1021,1044],{"type":42,"tag":373,"props":994,"children":995},{"class":375,"line":376},[996,1000,1004,1008,1013,1017],{"type":42,"tag":373,"props":997,"children":998},{"style":439},[999],{"type":47,"value":562},{"type":42,"tag":373,"props":1001,"children":1002},{"style":403},[1003],{"type":47,"value":723},{"type":42,"tag":373,"props":1005,"children":1006},{"style":392},[1007],{"type":47,"value":452},{"type":42,"tag":373,"props":1009,"children":1010},{"style":403},[1011],{"type":47,"value":1012},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Falice@example.com",{"type":42,"tag":373,"props":1014,"children":1015},{"style":392},[1016],{"type":47,"value":400},{"type":42,"tag":373,"props":1018,"children":1019},{"style":386},[1020],{"type":47,"value":466},{"type":42,"tag":373,"props":1022,"children":1023},{"class":375,"line":469},[1024,1028,1032,1036,1040],{"type":42,"tag":373,"props":1025,"children":1026},{"style":403},[1027],{"type":47,"value":748},{"type":42,"tag":373,"props":1029,"children":1030},{"style":392},[1031],{"type":47,"value":452},{"type":42,"tag":373,"props":1033,"children":1034},{"style":403},[1035],{"type":47,"value":983},{"type":42,"tag":373,"props":1037,"children":1038},{"style":392},[1039],{"type":47,"value":400},{"type":42,"tag":373,"props":1041,"children":1042},{"style":386},[1043],{"type":47,"value":466},{"type":42,"tag":373,"props":1045,"children":1046},{"class":375,"line":768},[1047,1051,1055,1060,1064,1068,1072],{"type":42,"tag":373,"props":1048,"children":1049},{"style":403},[1050],{"type":47,"value":748},{"type":42,"tag":373,"props":1052,"children":1053},{"style":392},[1054],{"type":47,"value":452},{"type":42,"tag":373,"props":1056,"children":1057},{"style":403},[1058],{"type":47,"value":1059},"properties=email,firstname,lastname",{"type":42,"tag":373,"props":1061,"children":1062},{"style":392},[1063],{"type":47,"value":400},{"type":42,"tag":373,"props":1065,"children":1066},{"style":392},[1067],{"type":47,"value":504},{"type":42,"tag":373,"props":1069,"children":1070},{"style":439},[1071],{"type":47,"value":509},{"type":42,"tag":373,"props":1073,"children":1074},{"style":403},[1075],{"type":47,"value":514},{"type":42,"tag":694,"props":1077,"children":1079},{"id":1078},"_3-create-a-record",[1080],{"type":47,"value":1081},"3. Create a record",{"type":42,"tag":362,"props":1083,"children":1085},{"className":364,"code":1084,"language":366,"meta":367,"style":367},"hsapi -X POST \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\" \\\n  -d '{\n    \"properties\": {\n      \"email\": \"alice@example.com\",\n      \"firstname\": \"Alice\",\n      \"lastname\": \"Nguyen\",\n      \"lifecyclestage\": \"lead\"\n    }\n  }' | jq 'if .status == \"error\" then . else {id, createdAt} end'\n",[1086],{"type":42,"tag":50,"props":1087,"children":1088},{"__ignoreMap":367},[1089,1122,1139,1147,1155,1164,1173,1182,1191],{"type":42,"tag":373,"props":1090,"children":1091},{"class":375,"line":376},[1092,1096,1101,1106,1110,1114,1118],{"type":42,"tag":373,"props":1093,"children":1094},{"style":439},[1095],{"type":47,"value":562},{"type":42,"tag":373,"props":1097,"children":1098},{"style":403},[1099],{"type":47,"value":1100}," -X",{"type":42,"tag":373,"props":1102,"children":1103},{"style":403},[1104],{"type":47,"value":1105}," POST",{"type":42,"tag":373,"props":1107,"children":1108},{"style":392},[1109],{"type":47,"value":452},{"type":42,"tag":373,"props":1111,"children":1112},{"style":403},[1113],{"type":47,"value":732},{"type":42,"tag":373,"props":1115,"children":1116},{"style":392},[1117],{"type":47,"value":400},{"type":42,"tag":373,"props":1119,"children":1120},{"style":386},[1121],{"type":47,"value":466},{"type":42,"tag":373,"props":1123,"children":1124},{"class":375,"line":469},[1125,1130,1134],{"type":42,"tag":373,"props":1126,"children":1127},{"style":403},[1128],{"type":47,"value":1129},"  -d",{"type":42,"tag":373,"props":1131,"children":1132},{"style":392},[1133],{"type":47,"value":824},{"type":42,"tag":373,"props":1135,"children":1136},{"style":403},[1137],{"type":47,"value":1138},"{\n",{"type":42,"tag":373,"props":1140,"children":1141},{"class":375,"line":768},[1142],{"type":42,"tag":373,"props":1143,"children":1144},{"style":403},[1145],{"type":47,"value":1146},"    \"properties\": {\n",{"type":42,"tag":373,"props":1148,"children":1149},{"class":375,"line":793},[1150],{"type":42,"tag":373,"props":1151,"children":1152},{"style":403},[1153],{"type":47,"value":1154},"      \"email\": \"alice@example.com\",\n",{"type":42,"tag":373,"props":1156,"children":1158},{"class":375,"line":1157},5,[1159],{"type":42,"tag":373,"props":1160,"children":1161},{"style":403},[1162],{"type":47,"value":1163},"      \"firstname\": \"Alice\",\n",{"type":42,"tag":373,"props":1165,"children":1167},{"class":375,"line":1166},6,[1168],{"type":42,"tag":373,"props":1169,"children":1170},{"style":403},[1171],{"type":47,"value":1172},"      \"lastname\": \"Nguyen\",\n",{"type":42,"tag":373,"props":1174,"children":1176},{"class":375,"line":1175},7,[1177],{"type":42,"tag":373,"props":1178,"children":1179},{"style":403},[1180],{"type":47,"value":1181},"      \"lifecyclestage\": \"lead\"\n",{"type":42,"tag":373,"props":1183,"children":1185},{"class":375,"line":1184},8,[1186],{"type":42,"tag":373,"props":1187,"children":1188},{"style":403},[1189],{"type":47,"value":1190},"    }\n",{"type":42,"tag":373,"props":1192,"children":1194},{"class":375,"line":1193},9,[1195,1200,1205,1209,1213,1217,1222],{"type":42,"tag":373,"props":1196,"children":1197},{"style":403},[1198],{"type":47,"value":1199},"  }",{"type":42,"tag":373,"props":1201,"children":1202},{"style":392},[1203],{"type":47,"value":1204},"'",{"type":42,"tag":373,"props":1206,"children":1207},{"style":392},[1208],{"type":47,"value":504},{"type":42,"tag":373,"props":1210,"children":1211},{"style":439},[1212],{"type":47,"value":509},{"type":42,"tag":373,"props":1214,"children":1215},{"style":392},[1216],{"type":47,"value":824},{"type":42,"tag":373,"props":1218,"children":1219},{"style":403},[1220],{"type":47,"value":1221},"if .status == \"error\" then . else {id, createdAt} end",{"type":42,"tag":373,"props":1223,"children":1224},{"style":392},[1225],{"type":47,"value":834},{"type":42,"tag":43,"props":1227,"children":1228},{},[1229,1231,1236,1238,1244],{"type":47,"value":1230},"To create ",{"type":42,"tag":105,"props":1232,"children":1233},{},[1234],{"type":47,"value":1235},"and associate",{"type":47,"value":1237}," in one call, add an ",{"type":42,"tag":50,"props":1239,"children":1241},{"className":1240},[],[1242],{"type":47,"value":1243},"associations",{"type":47,"value":1245}," array:",{"type":42,"tag":362,"props":1247,"children":1249},{"className":364,"code":1248,"language":366,"meta":367,"style":367},"hsapi -X POST \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fdeals\" \\\n  -d '{\n    \"properties\": {\n      \"dealname\": \"Acme expansion\",\n      \"pipeline\": \"default\",\n      \"dealstage\": \"appointmentscheduled\",\n      \"amount\": \"15000\"\n    },\n    \"associations\": [\n      {\"to\": {\"id\": \"COMPANY_ID\"}, \"types\": [{\"associationCategory\": \"HUBSPOT_DEFINED\", \"associationTypeId\": 341}]}\n    ]\n  }' | jq .\n",[1250],{"type":42,"tag":50,"props":1251,"children":1252},{"__ignoreMap":367},[1253,1285,1300,1307,1315,1323,1331,1339,1347,1355,1364,1373],{"type":42,"tag":373,"props":1254,"children":1255},{"class":375,"line":376},[1256,1260,1264,1268,1272,1277,1281],{"type":42,"tag":373,"props":1257,"children":1258},{"style":439},[1259],{"type":47,"value":562},{"type":42,"tag":373,"props":1261,"children":1262},{"style":403},[1263],{"type":47,"value":1100},{"type":42,"tag":373,"props":1265,"children":1266},{"style":403},[1267],{"type":47,"value":1105},{"type":42,"tag":373,"props":1269,"children":1270},{"style":392},[1271],{"type":47,"value":452},{"type":42,"tag":373,"props":1273,"children":1274},{"style":403},[1275],{"type":47,"value":1276},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fdeals",{"type":42,"tag":373,"props":1278,"children":1279},{"style":392},[1280],{"type":47,"value":400},{"type":42,"tag":373,"props":1282,"children":1283},{"style":386},[1284],{"type":47,"value":466},{"type":42,"tag":373,"props":1286,"children":1287},{"class":375,"line":469},[1288,1292,1296],{"type":42,"tag":373,"props":1289,"children":1290},{"style":403},[1291],{"type":47,"value":1129},{"type":42,"tag":373,"props":1293,"children":1294},{"style":392},[1295],{"type":47,"value":824},{"type":42,"tag":373,"props":1297,"children":1298},{"style":403},[1299],{"type":47,"value":1138},{"type":42,"tag":373,"props":1301,"children":1302},{"class":375,"line":768},[1303],{"type":42,"tag":373,"props":1304,"children":1305},{"style":403},[1306],{"type":47,"value":1146},{"type":42,"tag":373,"props":1308,"children":1309},{"class":375,"line":793},[1310],{"type":42,"tag":373,"props":1311,"children":1312},{"style":403},[1313],{"type":47,"value":1314},"      \"dealname\": \"Acme expansion\",\n",{"type":42,"tag":373,"props":1316,"children":1317},{"class":375,"line":1157},[1318],{"type":42,"tag":373,"props":1319,"children":1320},{"style":403},[1321],{"type":47,"value":1322},"      \"pipeline\": \"default\",\n",{"type":42,"tag":373,"props":1324,"children":1325},{"class":375,"line":1166},[1326],{"type":42,"tag":373,"props":1327,"children":1328},{"style":403},[1329],{"type":47,"value":1330},"      \"dealstage\": \"appointmentscheduled\",\n",{"type":42,"tag":373,"props":1332,"children":1333},{"class":375,"line":1175},[1334],{"type":42,"tag":373,"props":1335,"children":1336},{"style":403},[1337],{"type":47,"value":1338},"      \"amount\": \"15000\"\n",{"type":42,"tag":373,"props":1340,"children":1341},{"class":375,"line":1184},[1342],{"type":42,"tag":373,"props":1343,"children":1344},{"style":403},[1345],{"type":47,"value":1346},"    },\n",{"type":42,"tag":373,"props":1348,"children":1349},{"class":375,"line":1193},[1350],{"type":42,"tag":373,"props":1351,"children":1352},{"style":403},[1353],{"type":47,"value":1354},"    \"associations\": [\n",{"type":42,"tag":373,"props":1356,"children":1358},{"class":375,"line":1357},10,[1359],{"type":42,"tag":373,"props":1360,"children":1361},{"style":403},[1362],{"type":47,"value":1363},"      {\"to\": {\"id\": \"COMPANY_ID\"}, \"types\": [{\"associationCategory\": \"HUBSPOT_DEFINED\", \"associationTypeId\": 341}]}\n",{"type":42,"tag":373,"props":1365,"children":1367},{"class":375,"line":1366},11,[1368],{"type":42,"tag":373,"props":1369,"children":1370},{"style":403},[1371],{"type":47,"value":1372},"    ]\n",{"type":42,"tag":373,"props":1374,"children":1375},{"class":375,"line":30},[1376,1380,1384,1388,1392],{"type":42,"tag":373,"props":1377,"children":1378},{"style":403},[1379],{"type":47,"value":1199},{"type":42,"tag":373,"props":1381,"children":1382},{"style":392},[1383],{"type":47,"value":1204},{"type":42,"tag":373,"props":1385,"children":1386},{"style":392},[1387],{"type":47,"value":504},{"type":42,"tag":373,"props":1389,"children":1390},{"style":439},[1391],{"type":47,"value":509},{"type":42,"tag":373,"props":1393,"children":1394},{"style":403},[1395],{"type":47,"value":514},{"type":42,"tag":43,"props":1397,"children":1398},{},[1399,1405,1407,1413,1415,1421],{"type":42,"tag":50,"props":1400,"children":1402},{"className":1401},[],[1403],{"type":47,"value":1404},"341",{"type":47,"value":1406}," is ",{"type":42,"tag":50,"props":1408,"children":1410},{"className":1409},[],[1411],{"type":47,"value":1412},"deal_to_company",{"type":47,"value":1414},". See the association-type table in ",{"type":42,"tag":50,"props":1416,"children":1418},{"className":1417},[],[1419],{"type":47,"value":1420},"references\u002Fapi.md",{"type":47,"value":1422},", or discover them\nlive (op 8).",{"type":42,"tag":694,"props":1424,"children":1426},{"id":1425},"_4-update-a-record",[1427],{"type":47,"value":1428},"4. Update a record",{"type":42,"tag":43,"props":1430,"children":1431},{},[1432,1438],{"type":42,"tag":50,"props":1433,"children":1435},{"className":1434},[],[1436],{"type":47,"value":1437},"PATCH",{"type":47,"value":1439}," only the properties you want to change. Everything else is untouched.",{"type":42,"tag":362,"props":1441,"children":1443},{"className":364,"code":1442,"language":366,"meta":367,"style":367},"hsapi -X PATCH \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\" \\\n  -d '{\"properties\": {\"lifecyclestage\": \"marketingqualifiedlead\", \"phone\": \"+1-555-0100\"}}'\n",[1444],{"type":42,"tag":50,"props":1445,"children":1446},{"__ignoreMap":367},[1447,1479],{"type":42,"tag":373,"props":1448,"children":1449},{"class":375,"line":376},[1450,1454,1458,1463,1467,1471,1475],{"type":42,"tag":373,"props":1451,"children":1452},{"style":439},[1453],{"type":47,"value":562},{"type":42,"tag":373,"props":1455,"children":1456},{"style":403},[1457],{"type":47,"value":1100},{"type":42,"tag":373,"props":1459,"children":1460},{"style":403},[1461],{"type":47,"value":1462}," PATCH",{"type":42,"tag":373,"props":1464,"children":1465},{"style":392},[1466],{"type":47,"value":452},{"type":42,"tag":373,"props":1468,"children":1469},{"style":403},[1470],{"type":47,"value":909},{"type":42,"tag":373,"props":1472,"children":1473},{"style":392},[1474],{"type":47,"value":400},{"type":42,"tag":373,"props":1476,"children":1477},{"style":386},[1478],{"type":47,"value":466},{"type":42,"tag":373,"props":1480,"children":1481},{"class":375,"line":469},[1482,1486,1490,1495],{"type":42,"tag":373,"props":1483,"children":1484},{"style":403},[1485],{"type":47,"value":1129},{"type":42,"tag":373,"props":1487,"children":1488},{"style":392},[1489],{"type":47,"value":824},{"type":42,"tag":373,"props":1491,"children":1492},{"style":403},[1493],{"type":47,"value":1494},"{\"properties\": {\"lifecyclestage\": \"marketingqualifiedlead\", \"phone\": \"+1-555-0100\"}}",{"type":42,"tag":373,"props":1496,"children":1497},{"style":392},[1498],{"type":47,"value":834},{"type":42,"tag":43,"props":1500,"children":1501},{},[1502,1504,1510],{"type":47,"value":1503},"Updating by unique property works the same as reading — append ",{"type":42,"tag":50,"props":1505,"children":1507},{"className":1506},[],[1508],{"type":47,"value":1509},"?idProperty=email",{"type":47,"value":1511}," and put the email\nin the path.",{"type":42,"tag":694,"props":1513,"children":1515},{"id":1514},"_5-archive-delete-a-record",[1516],{"type":47,"value":1517},"5. Archive \u002F delete a record",{"type":42,"tag":43,"props":1519,"children":1520},{},[1521,1523,1529],{"type":47,"value":1522},"HubSpot \"deletes\" are soft (the record goes to the recycle bin for ~90 days). Success is a ",{"type":42,"tag":50,"props":1524,"children":1526},{"className":1525},[],[1527],{"type":47,"value":1528},"204",{"type":47,"value":1530},"\nwith an empty body, so print the status code:",{"type":42,"tag":362,"props":1532,"children":1534},{"className":364,"code":1533,"language":366,"meta":367,"style":367},"hsapi -X DELETE \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\" -w '\\n%{http_code}\\n'\n",[1535],{"type":42,"tag":50,"props":1536,"children":1537},{"__ignoreMap":367},[1538],{"type":42,"tag":373,"props":1539,"children":1540},{"class":375,"line":376},[1541,1545,1549,1554,1558,1562,1566,1571,1575,1580],{"type":42,"tag":373,"props":1542,"children":1543},{"style":439},[1544],{"type":47,"value":562},{"type":42,"tag":373,"props":1546,"children":1547},{"style":403},[1548],{"type":47,"value":1100},{"type":42,"tag":373,"props":1550,"children":1551},{"style":403},[1552],{"type":47,"value":1553}," DELETE",{"type":42,"tag":373,"props":1555,"children":1556},{"style":392},[1557],{"type":47,"value":452},{"type":42,"tag":373,"props":1559,"children":1560},{"style":403},[1561],{"type":47,"value":909},{"type":42,"tag":373,"props":1563,"children":1564},{"style":392},[1565],{"type":47,"value":400},{"type":42,"tag":373,"props":1567,"children":1568},{"style":403},[1569],{"type":47,"value":1570}," -w",{"type":42,"tag":373,"props":1572,"children":1573},{"style":392},[1574],{"type":47,"value":824},{"type":42,"tag":373,"props":1576,"children":1577},{"style":403},[1578],{"type":47,"value":1579},"\\n%{http_code}\\n",{"type":42,"tag":373,"props":1581,"children":1582},{"style":392},[1583],{"type":47,"value":834},{"type":42,"tag":43,"props":1585,"children":1586},{},[1587,1589,1595,1597,1603],{"type":47,"value":1588},"Batch delete: ",{"type":42,"tag":50,"props":1590,"children":1592},{"className":1591},[],[1593],{"type":47,"value":1594},"POST \u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Fbatch\u002Farchive",{"type":47,"value":1596}," with ",{"type":42,"tag":50,"props":1598,"children":1600},{"className":1599},[],[1601],{"type":47,"value":1602},"{\"inputs\": [{\"id\": \"...\"}, ...]}",{"type":47,"value":1604},".",{"type":42,"tag":694,"props":1606,"children":1608},{"id":1607},"_6-search-records-scriptshs_searchsh",[1609,1611,1617],{"type":47,"value":1610},"6. Search records (",{"type":42,"tag":50,"props":1612,"children":1614},{"className":1613},[],[1615],{"type":47,"value":1616},"scripts\u002Fhs_search.sh",{"type":47,"value":1618},")",{"type":42,"tag":43,"props":1620,"children":1621},{},[1622,1624,1630,1631,1637,1638,1644,1646,1652,1654,1660],{"type":47,"value":1623},"Search any object type through the bundled script (path is relative to this skill's directory): it\nbuilds the ",{"type":42,"tag":50,"props":1625,"children":1627},{"className":1626},[],[1628],{"type":47,"value":1629},"filterGroups",{"type":47,"value":78},{"type":42,"tag":50,"props":1632,"children":1634},{"className":1633},[],[1635],{"type":47,"value":1636},"sorts",{"type":47,"value":78},{"type":42,"tag":50,"props":1639,"children":1641},{"className":1640},[],[1642],{"type":47,"value":1643},"query",{"type":47,"value":1645}," body, posts to ",{"type":42,"tag":50,"props":1647,"children":1649},{"className":1648},[],[1650],{"type":47,"value":1651},"\u002Fcrm\u002Fv3\u002Fobjects\u002F{type}\u002Fsearch",{"type":47,"value":1653},", follows\n",{"type":42,"tag":50,"props":1655,"children":1657},{"className":1656},[],[1658],{"type":47,"value":1659},"paging.next.after",{"type":47,"value":1661}," through every page, and emits TSV or JSONL.",{"type":42,"tag":362,"props":1663,"children":1665},{"className":364,"code":1664,"language":366,"meta":367,"style":367},"scripts\u002Fhs_search.sh --object contacts \\\n  --filter lifecyclestage:EQ:lead \\\n  --filter createdate:GTE:2024-01-01T00:00:00Z \\\n  --sort createdate:desc --limit 200\n",[1666],{"type":42,"tag":50,"props":1667,"children":1668},{"__ignoreMap":367},[1669,1690,1707,1723],{"type":42,"tag":373,"props":1670,"children":1671},{"class":375,"line":376},[1672,1676,1681,1686],{"type":42,"tag":373,"props":1673,"children":1674},{"style":439},[1675],{"type":47,"value":1616},{"type":42,"tag":373,"props":1677,"children":1678},{"style":403},[1679],{"type":47,"value":1680}," --object",{"type":42,"tag":373,"props":1682,"children":1683},{"style":403},[1684],{"type":47,"value":1685}," contacts",{"type":42,"tag":373,"props":1687,"children":1688},{"style":386},[1689],{"type":47,"value":466},{"type":42,"tag":373,"props":1691,"children":1692},{"class":375,"line":469},[1693,1698,1703],{"type":42,"tag":373,"props":1694,"children":1695},{"style":403},[1696],{"type":47,"value":1697},"  --filter",{"type":42,"tag":373,"props":1699,"children":1700},{"style":403},[1701],{"type":47,"value":1702}," lifecyclestage:EQ:lead",{"type":42,"tag":373,"props":1704,"children":1705},{"style":386},[1706],{"type":47,"value":466},{"type":42,"tag":373,"props":1708,"children":1709},{"class":375,"line":768},[1710,1714,1719],{"type":42,"tag":373,"props":1711,"children":1712},{"style":403},[1713],{"type":47,"value":1697},{"type":42,"tag":373,"props":1715,"children":1716},{"style":403},[1717],{"type":47,"value":1718}," createdate:GTE:2024-01-01T00:00:00Z",{"type":42,"tag":373,"props":1720,"children":1721},{"style":386},[1722],{"type":47,"value":466},{"type":42,"tag":373,"props":1724,"children":1725},{"class":375,"line":793},[1726,1731,1736,1741],{"type":42,"tag":373,"props":1727,"children":1728},{"style":403},[1729],{"type":47,"value":1730},"  --sort",{"type":42,"tag":373,"props":1732,"children":1733},{"style":403},[1734],{"type":47,"value":1735}," createdate:desc",{"type":42,"tag":373,"props":1737,"children":1738},{"style":403},[1739],{"type":47,"value":1740}," --limit",{"type":42,"tag":373,"props":1742,"children":1744},{"style":1743},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1745],{"type":47,"value":1746}," 200\n",{"type":42,"tag":111,"props":1748,"children":1749},{},[1750,1800,1919,1946,1981],{"type":42,"tag":115,"props":1751,"children":1752},{},[1753,1759,1761,1766,1767,1772,1773,1778,1779,1784,1786,1791,1793,1798],{"type":42,"tag":50,"props":1754,"children":1756},{"className":1755},[],[1757],{"type":47,"value":1758},"--object TYPE",{"type":47,"value":1760}," (required) is ",{"type":42,"tag":50,"props":1762,"children":1764},{"className":1763},[],[1765],{"type":47,"value":130},{"type":47,"value":132},{"type":42,"tag":50,"props":1768,"children":1770},{"className":1769},[],[1771],{"type":47,"value":138},{"type":47,"value":132},{"type":42,"tag":50,"props":1774,"children":1776},{"className":1775},[],[1777],{"type":47,"value":145},{"type":47,"value":132},{"type":42,"tag":50,"props":1780,"children":1782},{"className":1781},[],[1783],{"type":47,"value":152},{"type":47,"value":1785},", or any object type\nname \u002F ",{"type":42,"tag":50,"props":1787,"children":1789},{"className":1788},[],[1790],{"type":47,"value":160},{"type":47,"value":1792},". Instance specifics come from ",{"type":42,"tag":50,"props":1794,"children":1796},{"className":1795},[],[1797],{"type":47,"value":494},{"type":47,"value":1799}," above.",{"type":42,"tag":115,"props":1801,"children":1802},{},[1803,1809,1811,1817,1819,1825,1827,1833,1834,1840,1842,1848,1850,1856,1858,1864,1866,1872,1873,1879,1880,1886,1888,1894,1896,1902,1903,1909,1911,1917],{"type":42,"tag":50,"props":1804,"children":1806},{"className":1805},[],[1807],{"type":47,"value":1808},"--filter PROP:OP:VALUE",{"type":47,"value":1810}," (repeatable) ANDs filters in one ",{"type":42,"tag":50,"props":1812,"children":1814},{"className":1813},[],[1815],{"type":47,"value":1816},"filterGroup",{"type":47,"value":1818},". ",{"type":42,"tag":50,"props":1820,"children":1822},{"className":1821},[],[1823],{"type":47,"value":1824},"OP",{"type":47,"value":1826}," is uppercased;\n",{"type":42,"tag":50,"props":1828,"children":1830},{"className":1829},[],[1831],{"type":47,"value":1832},"IN",{"type":47,"value":247},{"type":42,"tag":50,"props":1835,"children":1837},{"className":1836},[],[1838],{"type":47,"value":1839},"NOT_IN",{"type":47,"value":1841}," take a comma list (",{"type":42,"tag":50,"props":1843,"children":1845},{"className":1844},[],[1846],{"type":47,"value":1847},"dealstage:IN:won,lost",{"type":47,"value":1849}," → ",{"type":42,"tag":50,"props":1851,"children":1853},{"className":1852},[],[1854],{"type":47,"value":1855},"values",{"type":47,"value":1857},"; for string properties\nthe values must be lowercase), ",{"type":42,"tag":50,"props":1859,"children":1861},{"className":1860},[],[1862],{"type":47,"value":1863},"BETWEEN",{"type":47,"value":1865}," takes ",{"type":42,"tag":50,"props":1867,"children":1869},{"className":1868},[],[1870],{"type":47,"value":1871},"low,high",{"type":47,"value":162},{"type":42,"tag":50,"props":1874,"children":1876},{"className":1875},[],[1877],{"type":47,"value":1878},"amount:BETWEEN:100,500",{"type":47,"value":1849},{"type":42,"tag":50,"props":1881,"children":1883},{"className":1882},[],[1884],{"type":47,"value":1885},"value",{"type":47,"value":1887}," +\n",{"type":42,"tag":50,"props":1889,"children":1891},{"className":1890},[],[1892],{"type":47,"value":1893},"highValue",{"type":47,"value":1895},"), ",{"type":42,"tag":50,"props":1897,"children":1899},{"className":1898},[],[1900],{"type":47,"value":1901},"HAS_PROPERTY",{"type":47,"value":247},{"type":42,"tag":50,"props":1904,"children":1906},{"className":1905},[],[1907],{"type":47,"value":1908},"NOT_HAS_PROPERTY",{"type":47,"value":1910}," take no value. ",{"type":42,"tag":50,"props":1912,"children":1914},{"className":1913},[],[1915],{"type":47,"value":1916},"--query TEXT",{"type":47,"value":1918}," adds a free-text\nphrase match.",{"type":42,"tag":115,"props":1920,"children":1921},{},[1922,1928,1930,1936,1938,1944],{"type":42,"tag":50,"props":1923,"children":1925},{"className":1924},[],[1926],{"type":47,"value":1927},"--properties LIST",{"type":47,"value":1929}," drives both the request and the TSV columns; defaults are per-type\n(",{"type":42,"tag":50,"props":1931,"children":1933},{"className":1932},[],[1934],{"type":47,"value":1935},"email,firstname,lastname,createdate",{"type":47,"value":1937}," for contacts, etc.) and required for any other type.\n",{"type":42,"tag":50,"props":1939,"children":1941},{"className":1940},[],[1942],{"type":47,"value":1943},"--sort PROP[:desc]",{"type":47,"value":1945}," orders results.",{"type":42,"tag":115,"props":1947,"children":1948},{},[1949,1955,1957,1963,1965,1971,1973,1979],{"type":42,"tag":50,"props":1950,"children":1952},{"className":1951},[],[1953],{"type":47,"value":1954},"--limit N",{"type":47,"value":1956}," caps fetched rows (default 100, ",{"type":42,"tag":50,"props":1958,"children":1960},{"className":1959},[],[1961],{"type":47,"value":1962},"0",{"type":47,"value":1964}," = everything — search hard-caps at 10,000\nresults); ",{"type":42,"tag":50,"props":1966,"children":1968},{"className":1967},[],[1969],{"type":47,"value":1970},"--page-size N",{"type":47,"value":1972}," (max 200); ",{"type":42,"tag":50,"props":1974,"children":1976},{"className":1975},[],[1977],{"type":47,"value":1978},"--json",{"type":47,"value":1980}," emits one JSON object per record instead of TSV\nwith a header. Total match count and row counts go to stderr.",{"type":42,"tag":115,"props":1982,"children":1983},{},[1984,1986,1991,1993,1999,2001,2007,2009,2015],{"type":47,"value":1985},"Exit codes: ",{"type":42,"tag":50,"props":1987,"children":1989},{"className":1988},[],[1990],{"type":47,"value":1962},{"type":47,"value":1992}," success, ",{"type":42,"tag":50,"props":1994,"children":1996},{"className":1995},[],[1997],{"type":47,"value":1998},"1",{"type":47,"value":2000}," request failed or API error (",{"type":42,"tag":50,"props":2002,"children":2004},{"className":2003},[],[2005],{"type":47,"value":2006},"category",{"type":47,"value":2008}," and ",{"type":42,"tag":50,"props":2010,"children":2012},{"className":2011},[],[2013],{"type":47,"value":2014},"message",{"type":47,"value":2016}," on stderr) or\nbad arguments.",{"type":42,"tag":43,"props":2018,"children":2019},{},[2020,2022,2027,2029,2035,2037,2042],{"type":47,"value":2021},"If the script errors, read it — it's plain ",{"type":42,"tag":50,"props":2023,"children":2025},{"className":2024},[],[2026],{"type":47,"value":442},{"type":47,"value":2028}," + ",{"type":42,"tag":50,"props":2030,"children":2032},{"className":2031},[],[2033],{"type":47,"value":2034},"jq",{"type":47,"value":2036}," — and debug against ",{"type":42,"tag":50,"props":2038,"children":2040},{"className":2039},[],[2041],{"type":47,"value":1420},{"type":47,"value":1604},{"type":42,"tag":43,"props":2044,"children":2045},{},[2046,2048,2053,2055,2060,2062,2067,2069,2075],{"type":47,"value":2047},"The script emits one ANDed ",{"type":42,"tag":50,"props":2049,"children":2051},{"className":2050},[],[2052],{"type":47,"value":1816},{"type":47,"value":2054},". For ORed groups, post the raw body via ",{"type":42,"tag":50,"props":2056,"children":2058},{"className":2057},[],[2059],{"type":47,"value":562},{"type":47,"value":2061}," — limits\nare 5 groups, 6 filters per group, ",{"type":42,"tag":105,"props":2063,"children":2064},{},[2065],{"type":47,"value":2066},"18 filters total",{"type":47,"value":2068},". Search is eventually consistent: a record\ncreated or updated seconds ago may not appear yet — use a direct ",{"type":42,"tag":50,"props":2070,"children":2072},{"className":2071},[],[2073],{"type":47,"value":2074},"GET",{"type":47,"value":2076}," by ID for read-after-write.",{"type":42,"tag":694,"props":2078,"children":2080},{"id":2079},"_7-batch-read-create-update-upsert",[2081],{"type":47,"value":2082},"7. Batch read \u002F create \u002F update \u002F upsert",{"type":42,"tag":43,"props":2084,"children":2085},{},[2086,2088,2094,2096,2101,2103,2109],{"type":47,"value":2087},"The ",{"type":42,"tag":50,"props":2089,"children":2091},{"className":2090},[],[2092],{"type":47,"value":2093},"batch\u002F*",{"type":47,"value":2095}," endpoints trade one round trip for up to 100 records (some are lower — see\n",{"type":42,"tag":50,"props":2097,"children":2099},{"className":2098},[],[2100],{"type":47,"value":1420},{"type":47,"value":2102},"). All five verbs follow the same ",{"type":42,"tag":50,"props":2104,"children":2106},{"className":2105},[],[2107],{"type":47,"value":2108},"{\"inputs\": [...]}",{"type":47,"value":2110}," shape.",{"type":42,"tag":362,"props":2112,"children":2114},{"className":364,"code":2113,"language":366,"meta":367,"style":367},"# batch read by id\nhsapi -X POST \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Fbatch\u002Fread\" \\\n  -d '{\"inputs\": [{\"id\": \"101\"}, {\"id\": \"102\"}], \"properties\": [\"email\", \"firstname\"]}'\n\n# upsert by a unique property (create if new, update if the key matches)\nhsapi -X POST \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Fbatch\u002Fupsert\" \\\n  -d '{\"inputs\": [{\"idProperty\": \"email\", \"id\": \"a@x.com\", \"properties\": {\"firstname\": \"Alice\"}}]}'\n",[2115],{"type":42,"tag":50,"props":2116,"children":2117},{"__ignoreMap":367},[2118,2126,2158,2178,2187,2195,2227],{"type":42,"tag":373,"props":2119,"children":2120},{"class":375,"line":376},[2121],{"type":42,"tag":373,"props":2122,"children":2123},{"style":413},[2124],{"type":47,"value":2125},"# batch read by id\n",{"type":42,"tag":373,"props":2127,"children":2128},{"class":375,"line":469},[2129,2133,2137,2141,2145,2150,2154],{"type":42,"tag":373,"props":2130,"children":2131},{"style":439},[2132],{"type":47,"value":562},{"type":42,"tag":373,"props":2134,"children":2135},{"style":403},[2136],{"type":47,"value":1100},{"type":42,"tag":373,"props":2138,"children":2139},{"style":403},[2140],{"type":47,"value":1105},{"type":42,"tag":373,"props":2142,"children":2143},{"style":392},[2144],{"type":47,"value":452},{"type":42,"tag":373,"props":2146,"children":2147},{"style":403},[2148],{"type":47,"value":2149},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Fbatch\u002Fread",{"type":42,"tag":373,"props":2151,"children":2152},{"style":392},[2153],{"type":47,"value":400},{"type":42,"tag":373,"props":2155,"children":2156},{"style":386},[2157],{"type":47,"value":466},{"type":42,"tag":373,"props":2159,"children":2160},{"class":375,"line":768},[2161,2165,2169,2174],{"type":42,"tag":373,"props":2162,"children":2163},{"style":403},[2164],{"type":47,"value":1129},{"type":42,"tag":373,"props":2166,"children":2167},{"style":392},[2168],{"type":47,"value":824},{"type":42,"tag":373,"props":2170,"children":2171},{"style":403},[2172],{"type":47,"value":2173},"{\"inputs\": [{\"id\": \"101\"}, {\"id\": \"102\"}], \"properties\": [\"email\", \"firstname\"]}",{"type":42,"tag":373,"props":2175,"children":2176},{"style":392},[2177],{"type":47,"value":834},{"type":42,"tag":373,"props":2179,"children":2180},{"class":375,"line":793},[2181],{"type":42,"tag":373,"props":2182,"children":2184},{"emptyLinePlaceholder":2183},true,[2185],{"type":47,"value":2186},"\n",{"type":42,"tag":373,"props":2188,"children":2189},{"class":375,"line":1157},[2190],{"type":42,"tag":373,"props":2191,"children":2192},{"style":413},[2193],{"type":47,"value":2194},"# upsert by a unique property (create if new, update if the key matches)\n",{"type":42,"tag":373,"props":2196,"children":2197},{"class":375,"line":1166},[2198,2202,2206,2210,2214,2219,2223],{"type":42,"tag":373,"props":2199,"children":2200},{"style":439},[2201],{"type":47,"value":562},{"type":42,"tag":373,"props":2203,"children":2204},{"style":403},[2205],{"type":47,"value":1100},{"type":42,"tag":373,"props":2207,"children":2208},{"style":403},[2209],{"type":47,"value":1105},{"type":42,"tag":373,"props":2211,"children":2212},{"style":392},[2213],{"type":47,"value":452},{"type":42,"tag":373,"props":2215,"children":2216},{"style":403},[2217],{"type":47,"value":2218},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fobjects\u002Fcontacts\u002Fbatch\u002Fupsert",{"type":42,"tag":373,"props":2220,"children":2221},{"style":392},[2222],{"type":47,"value":400},{"type":42,"tag":373,"props":2224,"children":2225},{"style":386},[2226],{"type":47,"value":466},{"type":42,"tag":373,"props":2228,"children":2229},{"class":375,"line":1175},[2230,2234,2238,2243],{"type":42,"tag":373,"props":2231,"children":2232},{"style":403},[2233],{"type":47,"value":1129},{"type":42,"tag":373,"props":2235,"children":2236},{"style":392},[2237],{"type":47,"value":824},{"type":42,"tag":373,"props":2239,"children":2240},{"style":403},[2241],{"type":47,"value":2242},"{\"inputs\": [{\"idProperty\": \"email\", \"id\": \"a@x.com\", \"properties\": {\"firstname\": \"Alice\"}}]}",{"type":42,"tag":373,"props":2244,"children":2245},{"style":392},[2246],{"type":47,"value":834},{"type":42,"tag":43,"props":2248,"children":2249},{},[2250,2256,2257,2263,2265,2271,2273,2279],{"type":42,"tag":50,"props":2251,"children":2253},{"className":2252},[],[2254],{"type":47,"value":2255},"batch\u002Fcreate",{"type":47,"value":2008},{"type":42,"tag":50,"props":2258,"children":2260},{"className":2259},[],[2261],{"type":47,"value":2262},"batch\u002Fupdate",{"type":47,"value":2264}," take ",{"type":42,"tag":50,"props":2266,"children":2268},{"className":2267},[],[2269],{"type":47,"value":2270},"{\"inputs\": [{\"properties\": {...}}]}",{"type":47,"value":2272}," and\n",{"type":42,"tag":50,"props":2274,"children":2276},{"className":2275},[],[2277],{"type":47,"value":2278},"{\"inputs\": [{\"id\": \"...\", \"properties\": {...}}]}",{"type":47,"value":2280}," respectively.",{"type":42,"tag":694,"props":2282,"children":2284},{"id":2283},"_8-list-and-create-associations",[2285],{"type":47,"value":2286},"8. List and create associations",{"type":42,"tag":43,"props":2288,"children":2289},{},[2290],{"type":47,"value":2291},"Use the v4 associations endpoints — they're newer and carry the label\u002Ftype info you actually want.\nThey coexist with v3.",{"type":42,"tag":362,"props":2293,"children":2295},{"className":364,"code":2294,"language":366,"meta":367,"style":367},"# what's associated with this contact?\nhsapi \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\u002Fassociations\u002Fcompanies\" | jq '.results'\n\n# discover association type ids between two object types\nhsapi \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fassociations\u002Fcontacts\u002Fcompanies\u002Flabels\" | jq '.results'\n\n# create an association (PUT — idempotent)\nhsapi -X PUT \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\u002Fassociations\u002Fcompanies\u002FCOMPANY_ID\" \\\n  -d '[{\"associationCategory\": \"HUBSPOT_DEFINED\", \"associationTypeId\": 1}]'\n\n# remove (204 on success, empty body)\nhsapi -X DELETE \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\u002Fassociations\u002Fcompanies\u002FCOMPANY_ID\" -w '\\n%{http_code}\\n'\n",[2296],{"type":42,"tag":50,"props":2297,"children":2298},{"__ignoreMap":367},[2299,2307,2347,2354,2362,2402,2409,2417,2450,2470,2477,2485],{"type":42,"tag":373,"props":2300,"children":2301},{"class":375,"line":376},[2302],{"type":42,"tag":373,"props":2303,"children":2304},{"style":413},[2305],{"type":47,"value":2306},"# what's associated with this contact?\n",{"type":42,"tag":373,"props":2308,"children":2309},{"class":375,"line":469},[2310,2314,2318,2323,2327,2331,2335,2339,2343],{"type":42,"tag":373,"props":2311,"children":2312},{"style":439},[2313],{"type":47,"value":562},{"type":42,"tag":373,"props":2315,"children":2316},{"style":392},[2317],{"type":47,"value":452},{"type":42,"tag":373,"props":2319,"children":2320},{"style":403},[2321],{"type":47,"value":2322},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\u002Fassociations\u002Fcompanies",{"type":42,"tag":373,"props":2324,"children":2325},{"style":392},[2326],{"type":47,"value":400},{"type":42,"tag":373,"props":2328,"children":2329},{"style":392},[2330],{"type":47,"value":504},{"type":42,"tag":373,"props":2332,"children":2333},{"style":439},[2334],{"type":47,"value":509},{"type":42,"tag":373,"props":2336,"children":2337},{"style":392},[2338],{"type":47,"value":824},{"type":42,"tag":373,"props":2340,"children":2341},{"style":403},[2342],{"type":47,"value":853},{"type":42,"tag":373,"props":2344,"children":2345},{"style":392},[2346],{"type":47,"value":834},{"type":42,"tag":373,"props":2348,"children":2349},{"class":375,"line":768},[2350],{"type":42,"tag":373,"props":2351,"children":2352},{"emptyLinePlaceholder":2183},[2353],{"type":47,"value":2186},{"type":42,"tag":373,"props":2355,"children":2356},{"class":375,"line":793},[2357],{"type":42,"tag":373,"props":2358,"children":2359},{"style":413},[2360],{"type":47,"value":2361},"# discover association type ids between two object types\n",{"type":42,"tag":373,"props":2363,"children":2364},{"class":375,"line":1157},[2365,2369,2373,2378,2382,2386,2390,2394,2398],{"type":42,"tag":373,"props":2366,"children":2367},{"style":439},[2368],{"type":47,"value":562},{"type":42,"tag":373,"props":2370,"children":2371},{"style":392},[2372],{"type":47,"value":452},{"type":42,"tag":373,"props":2374,"children":2375},{"style":403},[2376],{"type":47,"value":2377},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fassociations\u002Fcontacts\u002Fcompanies\u002Flabels",{"type":42,"tag":373,"props":2379,"children":2380},{"style":392},[2381],{"type":47,"value":400},{"type":42,"tag":373,"props":2383,"children":2384},{"style":392},[2385],{"type":47,"value":504},{"type":42,"tag":373,"props":2387,"children":2388},{"style":439},[2389],{"type":47,"value":509},{"type":42,"tag":373,"props":2391,"children":2392},{"style":392},[2393],{"type":47,"value":824},{"type":42,"tag":373,"props":2395,"children":2396},{"style":403},[2397],{"type":47,"value":853},{"type":42,"tag":373,"props":2399,"children":2400},{"style":392},[2401],{"type":47,"value":834},{"type":42,"tag":373,"props":2403,"children":2404},{"class":375,"line":1166},[2405],{"type":42,"tag":373,"props":2406,"children":2407},{"emptyLinePlaceholder":2183},[2408],{"type":47,"value":2186},{"type":42,"tag":373,"props":2410,"children":2411},{"class":375,"line":1175},[2412],{"type":42,"tag":373,"props":2413,"children":2414},{"style":413},[2415],{"type":47,"value":2416},"# create an association (PUT — idempotent)\n",{"type":42,"tag":373,"props":2418,"children":2419},{"class":375,"line":1184},[2420,2424,2428,2433,2437,2442,2446],{"type":42,"tag":373,"props":2421,"children":2422},{"style":439},[2423],{"type":47,"value":562},{"type":42,"tag":373,"props":2425,"children":2426},{"style":403},[2427],{"type":47,"value":1100},{"type":42,"tag":373,"props":2429,"children":2430},{"style":403},[2431],{"type":47,"value":2432}," PUT",{"type":42,"tag":373,"props":2434,"children":2435},{"style":392},[2436],{"type":47,"value":452},{"type":42,"tag":373,"props":2438,"children":2439},{"style":403},[2440],{"type":47,"value":2441},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv4\u002Fobjects\u002Fcontacts\u002FCONTACT_ID\u002Fassociations\u002Fcompanies\u002FCOMPANY_ID",{"type":42,"tag":373,"props":2443,"children":2444},{"style":392},[2445],{"type":47,"value":400},{"type":42,"tag":373,"props":2447,"children":2448},{"style":386},[2449],{"type":47,"value":466},{"type":42,"tag":373,"props":2451,"children":2452},{"class":375,"line":1193},[2453,2457,2461,2466],{"type":42,"tag":373,"props":2454,"children":2455},{"style":403},[2456],{"type":47,"value":1129},{"type":42,"tag":373,"props":2458,"children":2459},{"style":392},[2460],{"type":47,"value":824},{"type":42,"tag":373,"props":2462,"children":2463},{"style":403},[2464],{"type":47,"value":2465},"[{\"associationCategory\": \"HUBSPOT_DEFINED\", \"associationTypeId\": 1}]",{"type":42,"tag":373,"props":2467,"children":2468},{"style":392},[2469],{"type":47,"value":834},{"type":42,"tag":373,"props":2471,"children":2472},{"class":375,"line":1357},[2473],{"type":42,"tag":373,"props":2474,"children":2475},{"emptyLinePlaceholder":2183},[2476],{"type":47,"value":2186},{"type":42,"tag":373,"props":2478,"children":2479},{"class":375,"line":1366},[2480],{"type":42,"tag":373,"props":2481,"children":2482},{"style":413},[2483],{"type":47,"value":2484},"# remove (204 on success, empty body)\n",{"type":42,"tag":373,"props":2486,"children":2487},{"class":375,"line":30},[2488,2492,2496,2500,2504,2508,2512,2516,2520,2524],{"type":42,"tag":373,"props":2489,"children":2490},{"style":439},[2491],{"type":47,"value":562},{"type":42,"tag":373,"props":2493,"children":2494},{"style":403},[2495],{"type":47,"value":1100},{"type":42,"tag":373,"props":2497,"children":2498},{"style":403},[2499],{"type":47,"value":1553},{"type":42,"tag":373,"props":2501,"children":2502},{"style":392},[2503],{"type":47,"value":452},{"type":42,"tag":373,"props":2505,"children":2506},{"style":403},[2507],{"type":47,"value":2441},{"type":42,"tag":373,"props":2509,"children":2510},{"style":392},[2511],{"type":47,"value":400},{"type":42,"tag":373,"props":2513,"children":2514},{"style":403},[2515],{"type":47,"value":1570},{"type":42,"tag":373,"props":2517,"children":2518},{"style":392},[2519],{"type":47,"value":824},{"type":42,"tag":373,"props":2521,"children":2522},{"style":403},[2523],{"type":47,"value":1579},{"type":42,"tag":373,"props":2525,"children":2526},{"style":392},[2527],{"type":47,"value":834},{"type":42,"tag":694,"props":2529,"children":2531},{"id":2530},"_9-discover-properties-schema",[2532],{"type":47,"value":2533},"9. Discover properties (schema)",{"type":42,"tag":43,"props":2535,"children":2536},{},[2537,2539,2545,2547,2553],{"type":47,"value":2538},"Read the property catalog for an object type to learn field names, types, and ",{"type":42,"tag":50,"props":2540,"children":2542},{"className":2541},[],[2543],{"type":47,"value":2544},"options",{"type":47,"value":2546}," for\nenumerated fields (pipelines, stages, lifecycle stages, etc.). Do this before creating or filtering\n— guessing property names is the most common source of ",{"type":42,"tag":50,"props":2548,"children":2550},{"className":2549},[],[2551],{"type":47,"value":2552},"400",{"type":47,"value":2554}," errors.",{"type":42,"tag":362,"props":2556,"children":2558},{"className":364,"code":2557,"language":366,"meta":367,"style":367},"hsapi \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fproperties\u002Fcontacts\" | \\\n  jq '.results[] | {name, label, type, fieldType, options: (.options | length)}'\n\n# one property with its option values\nhsapi \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fproperties\u002Fdeals\u002Fdealstage\" | jq '{name, options: [.options[] | {label, value}]}'\n",[2559],{"type":42,"tag":50,"props":2560,"children":2561},{"__ignoreMap":367},[2562,2590,2611,2618,2626],{"type":42,"tag":373,"props":2563,"children":2564},{"class":375,"line":376},[2565,2569,2573,2578,2582,2586],{"type":42,"tag":373,"props":2566,"children":2567},{"style":439},[2568],{"type":47,"value":562},{"type":42,"tag":373,"props":2570,"children":2571},{"style":392},[2572],{"type":47,"value":452},{"type":42,"tag":373,"props":2574,"children":2575},{"style":403},[2576],{"type":47,"value":2577},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fproperties\u002Fcontacts",{"type":42,"tag":373,"props":2579,"children":2580},{"style":392},[2581],{"type":47,"value":400},{"type":42,"tag":373,"props":2583,"children":2584},{"style":392},[2585],{"type":47,"value":504},{"type":42,"tag":373,"props":2587,"children":2588},{"style":386},[2589],{"type":47,"value":466},{"type":42,"tag":373,"props":2591,"children":2592},{"class":375,"line":469},[2593,2598,2602,2607],{"type":42,"tag":373,"props":2594,"children":2595},{"style":439},[2596],{"type":47,"value":2597},"  jq",{"type":42,"tag":373,"props":2599,"children":2600},{"style":392},[2601],{"type":47,"value":824},{"type":42,"tag":373,"props":2603,"children":2604},{"style":403},[2605],{"type":47,"value":2606},".results[] | {name, label, type, fieldType, options: (.options | length)}",{"type":42,"tag":373,"props":2608,"children":2609},{"style":392},[2610],{"type":47,"value":834},{"type":42,"tag":373,"props":2612,"children":2613},{"class":375,"line":768},[2614],{"type":42,"tag":373,"props":2615,"children":2616},{"emptyLinePlaceholder":2183},[2617],{"type":47,"value":2186},{"type":42,"tag":373,"props":2619,"children":2620},{"class":375,"line":793},[2621],{"type":42,"tag":373,"props":2622,"children":2623},{"style":413},[2624],{"type":47,"value":2625},"# one property with its option values\n",{"type":42,"tag":373,"props":2627,"children":2628},{"class":375,"line":1157},[2629,2633,2637,2642,2646,2650,2654,2658,2663],{"type":42,"tag":373,"props":2630,"children":2631},{"style":439},[2632],{"type":47,"value":562},{"type":42,"tag":373,"props":2634,"children":2635},{"style":392},[2636],{"type":47,"value":452},{"type":42,"tag":373,"props":2638,"children":2639},{"style":403},[2640],{"type":47,"value":2641},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fproperties\u002Fdeals\u002Fdealstage",{"type":42,"tag":373,"props":2643,"children":2644},{"style":392},[2645],{"type":47,"value":400},{"type":42,"tag":373,"props":2647,"children":2648},{"style":392},[2649],{"type":47,"value":504},{"type":42,"tag":373,"props":2651,"children":2652},{"style":439},[2653],{"type":47,"value":509},{"type":42,"tag":373,"props":2655,"children":2656},{"style":392},[2657],{"type":47,"value":824},{"type":42,"tag":373,"props":2659,"children":2660},{"style":403},[2661],{"type":47,"value":2662},"{name, options: [.options[] | {label, value}]}",{"type":42,"tag":373,"props":2664,"children":2665},{"style":392},[2666],{"type":47,"value":834},{"type":42,"tag":694,"props":2668,"children":2670},{"id":2669},"_10-pipelines-and-stages",[2671],{"type":47,"value":2672},"10. Pipelines and stages",{"type":42,"tag":43,"props":2674,"children":2675},{},[2676,2678,2683,2685,2691,2692,2698],{"type":47,"value":2677},"Deals and tickets live in pipelines with ordered stages. Stage and pipeline ",{"type":42,"tag":105,"props":2679,"children":2680},{},[2681],{"type":47,"value":2682},"IDs",{"type":47,"value":2684}," (not labels) are\nwhat go in ",{"type":42,"tag":50,"props":2686,"children":2688},{"className":2687},[],[2689],{"type":47,"value":2690},"dealstage",{"type":47,"value":247},{"type":42,"tag":50,"props":2693,"children":2695},{"className":2694},[],[2696],{"type":47,"value":2697},"hs_pipeline_stage",{"type":47,"value":2699}," properties.",{"type":42,"tag":362,"props":2701,"children":2703},{"className":364,"code":2702,"language":366,"meta":367,"style":367},"hsapi \"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fpipelines\u002Fdeals\" | \\\n  jq '.results[] | {id, label, stages: [.stages[] | {id, label, displayOrder}]}'\n",[2704],{"type":42,"tag":50,"props":2705,"children":2706},{"__ignoreMap":367},[2707,2735],{"type":42,"tag":373,"props":2708,"children":2709},{"class":375,"line":376},[2710,2714,2718,2723,2727,2731],{"type":42,"tag":373,"props":2711,"children":2712},{"style":439},[2713],{"type":47,"value":562},{"type":42,"tag":373,"props":2715,"children":2716},{"style":392},[2717],{"type":47,"value":452},{"type":42,"tag":373,"props":2719,"children":2720},{"style":403},[2721],{"type":47,"value":2722},"https:\u002F\u002Fapi.hubapi.com\u002Fcrm\u002Fv3\u002Fpipelines\u002Fdeals",{"type":42,"tag":373,"props":2724,"children":2725},{"style":392},[2726],{"type":47,"value":400},{"type":42,"tag":373,"props":2728,"children":2729},{"style":392},[2730],{"type":47,"value":504},{"type":42,"tag":373,"props":2732,"children":2733},{"style":386},[2734],{"type":47,"value":466},{"type":42,"tag":373,"props":2736,"children":2737},{"class":375,"line":469},[2738,2742,2746,2751],{"type":42,"tag":373,"props":2739,"children":2740},{"style":439},[2741],{"type":47,"value":2597},{"type":42,"tag":373,"props":2743,"children":2744},{"style":392},[2745],{"type":47,"value":824},{"type":42,"tag":373,"props":2747,"children":2748},{"style":403},[2749],{"type":47,"value":2750},".results[] | {id, label, stages: [.stages[] | {id, label, displayOrder}]}",{"type":42,"tag":373,"props":2752,"children":2753},{"style":392},[2754],{"type":47,"value":834},{"type":42,"tag":315,"props":2756,"children":2758},{"id":2757},"pagination",[2759],{"type":47,"value":2760},"Pagination",{"type":42,"tag":43,"props":2762,"children":2763},{},[2764,2766,2772,2774,2780,2782,2787,2789,2795,2797,2803,2805,2810,2812,2818,2820,2826],{"type":47,"value":2765},"List endpoints (",{"type":42,"tag":50,"props":2767,"children":2769},{"className":2768},[],[2770],{"type":47,"value":2771},"GET \u002Fcrm\u002Fv3\u002Fobjects\u002F{type}",{"type":47,"value":2773},", property lists, association lists) and search\n(",{"type":42,"tag":50,"props":2775,"children":2777},{"className":2776},[],[2778],{"type":47,"value":2779},"POST ...\u002Fsearch",{"type":47,"value":2781},") both use cursor pagination: response carries ",{"type":42,"tag":50,"props":2783,"children":2785},{"className":2784},[],[2786],{"type":47,"value":1659},{"type":47,"value":2788}," when more\nresults exist; pass it back as ",{"type":42,"tag":50,"props":2790,"children":2792},{"className":2791},[],[2793],{"type":47,"value":2794},"after",{"type":47,"value":2796}," (query param for GET, body field for search). ",{"type":42,"tag":50,"props":2798,"children":2800},{"className":2799},[],[2801],{"type":47,"value":2802},"limit",{"type":47,"value":2804}," maxes\nat 100 for list, 200 for search; search is additionally hard-capped at ",{"type":42,"tag":105,"props":2806,"children":2807},{},[2808],{"type":47,"value":2809},"10,000 total results",{"type":47,"value":2811}," per\nquery — narrow the filter if you need more. An error body has no ",{"type":42,"tag":50,"props":2813,"children":2815},{"className":2814},[],[2816],{"type":47,"value":2817},".paging",{"type":47,"value":2819}," — bound any loop and\nbreak on ",{"type":42,"tag":50,"props":2821,"children":2823},{"className":2822},[],[2824],{"type":47,"value":2825},".status == \"error\"",{"type":47,"value":1604},{"type":42,"tag":315,"props":2828,"children":2830},{"id":2829},"rate-limits",[2831],{"type":47,"value":2832},"Rate limits",{"type":42,"tag":43,"props":2834,"children":2835},{},[2836,2838,2843,2845,2850,2852,2857],{"type":47,"value":2837},"Private-app tokens get ",{"type":42,"tag":105,"props":2839,"children":2840},{},[2841],{"type":47,"value":2842},"100 requests per 10 seconds",{"type":47,"value":2844}," on Free\u002FStarter accounts and ",{"type":42,"tag":105,"props":2846,"children":2847},{},[2848],{"type":47,"value":2849},"190 per 10\nseconds",{"type":47,"value":2851}," on Professional\u002FEnterprise (plus daily caps that scale with the account tier). Search\nendpoints are limited to ",{"type":42,"tag":105,"props":2853,"children":2854},{},[2855],{"type":47,"value":2856},"5 requests per second per account",{"type":47,"value":2858}," and their responses do not carry the\nrate-limit headers. Every other response carries:",{"type":42,"tag":362,"props":2860,"children":2864},{"className":2861,"code":2863,"language":47},[2862],"language-text","X-HubSpot-RateLimit-Max          requests allowed per interval\nX-HubSpot-RateLimit-Remaining    requests left in the current interval\nX-HubSpot-RateLimit-Interval-Milliseconds   interval length\nX-HubSpot-RateLimit-Daily \u002F -Daily-Remaining\n",[2865],{"type":42,"tag":50,"props":2866,"children":2867},{"__ignoreMap":367},[2868],{"type":47,"value":2863},{"type":42,"tag":43,"props":2870,"children":2871},{},[2872,2874,2880,2882,2888],{"type":47,"value":2873},"On ",{"type":42,"tag":50,"props":2875,"children":2877},{"className":2876},[],[2878],{"type":47,"value":2879},"429",{"type":47,"value":2881},", sleep for ",{"type":42,"tag":50,"props":2883,"children":2885},{"className":2884},[],[2886],{"type":47,"value":2887},"X-HubSpot-RateLimit-Interval-Milliseconds",{"type":47,"value":2889}," (or ~10s if absent) and retry.\nPrefer batch endpoints — one batch call of 100 records counts as one request.",{"type":42,"tag":315,"props":2891,"children":2893},{"id":2892},"error-handling",[2894],{"type":47,"value":2895},"Error handling",{"type":42,"tag":43,"props":2897,"children":2898},{},[2899,2901,2907,2909,2915,2917,2922,2923,2929,2931,2936,2937,2942],{"type":47,"value":2900},"Errors are JSON: ",{"type":42,"tag":50,"props":2902,"children":2904},{"className":2903},[],[2905],{"type":47,"value":2906},"{\"status\": \"error\", \"message\": \"...\", \"correlationId\": \"...\", \"category\": \"...\"}",{"type":47,"value":2908},".\nCheck ",{"type":42,"tag":50,"props":2910,"children":2912},{"className":2911},[],[2913],{"type":47,"value":2914},".status",{"type":47,"value":2916}," before projecting ",{"type":42,"tag":50,"props":2918,"children":2920},{"className":2919},[],[2921],{"type":47,"value":853},{"type":47,"value":247},{"type":42,"tag":50,"props":2924,"children":2926},{"className":2925},[],[2927],{"type":47,"value":2928},".id",{"type":47,"value":2930}," — the error envelope has neither and a bare\nprojection prints nulls. Always surface ",{"type":42,"tag":50,"props":2932,"children":2934},{"className":2933},[],[2935],{"type":47,"value":2014},{"type":47,"value":2008},{"type":42,"tag":50,"props":2938,"children":2940},{"className":2939},[],[2941],{"type":47,"value":2006},{"type":47,"value":1604},{"type":42,"tag":111,"props":2944,"children":2945},{},[2946,2975,3002,3022,3058,3079,3122],{"type":42,"tag":115,"props":2947,"children":2948},{},[2949,2965,2967,2973],{"type":42,"tag":105,"props":2950,"children":2951},{},[2952,2957,2959],{"type":42,"tag":50,"props":2953,"children":2955},{"className":2954},[],[2956],{"type":47,"value":2552},{"type":47,"value":2958}," ",{"type":42,"tag":50,"props":2960,"children":2962},{"className":2961},[],[2963],{"type":47,"value":2964},"VALIDATION_ERROR",{"type":47,"value":2966}," — Bad property name\u002Fvalue, malformed filter, wrong enum value. Read ",{"type":42,"tag":50,"props":2968,"children":2970},{"className":2969},[],[2971],{"type":47,"value":2972},"errors[]",{"type":47,"value":2974}," — it names the offending field. Check the property catalog (op 9).",{"type":42,"tag":115,"props":2976,"children":2977},{},[2978,2993,2995,3000],{"type":42,"tag":105,"props":2979,"children":2980},{},[2981,2986,2987],{"type":42,"tag":50,"props":2982,"children":2984},{"className":2983},[],[2985],{"type":47,"value":331},{"type":47,"value":2958},{"type":42,"tag":50,"props":2988,"children":2990},{"className":2989},[],[2991],{"type":47,"value":2992},"INVALID_AUTHENTICATION",{"type":47,"value":2994}," — Credential missing or rejected. Check ",{"type":42,"tag":50,"props":2996,"children":2998},{"className":2997},[],[2999],{"type":47,"value":494},{"type":47,"value":3001}," is set at all; if it persists, the credential isn't configured for this workspace — report it.",{"type":42,"tag":115,"props":3003,"children":3004},{},[3005,3020],{"type":42,"tag":105,"props":3006,"children":3007},{},[3008,3013,3014],{"type":42,"tag":50,"props":3009,"children":3011},{"className":3010},[],[3012],{"type":47,"value":338},{"type":47,"value":2958},{"type":42,"tag":50,"props":3015,"children":3017},{"className":3016},[],[3018],{"type":47,"value":3019},"MISSING_SCOPES",{"type":47,"value":3021}," — The configured credential lacks the scope for this endpoint. The message names the missing scope — report it.",{"type":42,"tag":115,"props":3023,"children":3024},{},[3025,3041,3043,3049,3051,3057],{"type":42,"tag":105,"props":3026,"children":3027},{},[3028,3034,3035],{"type":42,"tag":50,"props":3029,"children":3031},{"className":3030},[],[3032],{"type":47,"value":3033},"404",{"type":47,"value":2958},{"type":42,"tag":50,"props":3036,"children":3038},{"className":3037},[],[3039],{"type":47,"value":3040},"OBJECT_NOT_FOUND",{"type":47,"value":3042}," — Bad ID, wrong ",{"type":42,"tag":50,"props":3044,"children":3046},{"className":3045},[],[3047],{"type":47,"value":3048},"objectType",{"type":47,"value":3050},", or record was deleted\u002Farchived. Try ",{"type":42,"tag":50,"props":3052,"children":3054},{"className":3053},[],[3055],{"type":47,"value":3056},"archived=true",{"type":47,"value":1604},{"type":42,"tag":115,"props":3059,"children":3060},{},[3061,3077],{"type":42,"tag":105,"props":3062,"children":3063},{},[3064,3070,3071],{"type":42,"tag":50,"props":3065,"children":3067},{"className":3066},[],[3068],{"type":47,"value":3069},"409",{"type":47,"value":2958},{"type":42,"tag":50,"props":3072,"children":3074},{"className":3073},[],[3075],{"type":47,"value":3076},"CONFLICT",{"type":47,"value":3078}," — Duplicate on a unique key (e.g., creating a contact with an existing email). Switch to upsert or patch the existing record.",{"type":42,"tag":115,"props":3080,"children":3081},{},[3082,3097,3099,3105,3107,3112,3114,3120],{"type":42,"tag":105,"props":3083,"children":3084},{},[3085,3090,3091],{"type":42,"tag":50,"props":3086,"children":3088},{"className":3087},[],[3089],{"type":47,"value":2879},{"type":47,"value":2958},{"type":42,"tag":50,"props":3092,"children":3094},{"className":3093},[],[3095],{"type":47,"value":3096},"RATE_LIMITS",{"type":47,"value":3098}," — The body's ",{"type":42,"tag":50,"props":3100,"children":3102},{"className":3101},[],[3103],{"type":47,"value":3104},"policyName",{"type":47,"value":3106}," says which limit you hit: a secondly\u002Fburst policy → sleep per ",{"type":42,"tag":50,"props":3108,"children":3110},{"className":3109},[],[3111],{"type":47,"value":2887},{"type":47,"value":3113},", retry; ",{"type":42,"tag":50,"props":3115,"children":3117},{"className":3116},[],[3118],{"type":47,"value":3119},"DAILY",{"type":47,"value":3121}," → stop, it resets at midnight account-local time.",{"type":42,"tag":115,"props":3123,"children":3124},{},[3125,3134],{"type":42,"tag":105,"props":3126,"children":3127},{},[3128],{"type":42,"tag":50,"props":3129,"children":3131},{"className":3130},[],[3132],{"type":47,"value":3133},"5xx",{"type":47,"value":3135}," — Transient. Retry with backoff.",{"type":42,"tag":315,"props":3137,"children":3139},{"id":3138},"going-deeper",[3140],{"type":47,"value":3141},"Going deeper",{"type":42,"tag":43,"props":3143,"children":3144},{},[3145,3150],{"type":42,"tag":50,"props":3146,"children":3148},{"className":3147},[],[3149],{"type":47,"value":1420},{"type":47,"value":3151}," has the fuller endpoint catalog — the complete default-property lists per object\ntype, the built-in association type ID table, batch limits, the owners\u002Fpipelines\u002Fproperties\nmanagement endpoints, custom object schemas, lists, and the engagement object types (notes, calls,\ntasks, meetings, emails). Read it when you need an endpoint or ID not covered above.",{"type":42,"tag":3153,"props":3154,"children":3155},"style",{},[3156],{"type":47,"value":3157},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":3159,"total":3346},[3160,3181,3195,3207,3226,3239,3260,3280,3294,3309,3317,3330],{"slug":3161,"name":3161,"fn":3162,"description":3163,"org":3164,"tags":3165,"stars":3178,"repoUrl":3179,"updatedAt":3180},"algorithmic-art","create algorithmic art with p5.js","Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3166,3169,3172,3175],{"name":3167,"slug":3168,"type":16},"Creative","creative",{"name":3170,"slug":3171,"type":16},"Design","design",{"name":3173,"slug":3174,"type":16},"Generative Art","generative-art",{"name":3176,"slug":3177,"type":16},"JavaScript","javascript",161831,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fskills","2026-04-06T17:56:15.455818",{"slug":3182,"name":3182,"fn":3183,"description":3184,"org":3185,"tags":3186,"stars":3178,"repoUrl":3179,"updatedAt":3194},"brand-guidelines","apply Anthropic brand colors and typography","Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3187,3190,3191],{"name":3188,"slug":3189,"type":16},"Branding","branding",{"name":3170,"slug":3171,"type":16},{"name":3192,"slug":3193,"type":16},"Typography","typography","2026-04-06T17:56:05.042852",{"slug":3196,"name":3196,"fn":3197,"description":3198,"org":3199,"tags":3200,"stars":3178,"repoUrl":3179,"updatedAt":3206},"canvas-design","create posters and visual art as PNG or PDF","Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3201,3202,3203],{"name":3167,"slug":3168,"type":16},{"name":3170,"slug":3171,"type":16},{"name":3204,"slug":3205,"type":16},"PDF","pdf","2026-04-06T17:56:03.794732",{"slug":3208,"name":3208,"fn":3209,"description":3210,"org":3211,"tags":3212,"stars":3178,"repoUrl":3179,"updatedAt":3225},"claude-api","build apps with the Claude API","Reference for the Claude API \u002F Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration.\nTRIGGER — read BEFORE opening the target file; don't skip because it \"looks like a one-liner\" — whenever: the prompt names Claude\u002FAnthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing\u002Fmodel choice\u002Flimits\u002Fcaching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent\u002FMCP\u002Ftool-definition\u002Fmulti-agent\u002FRAG\u002FLLM-judge\u002Fcomputer-use; generate\u002Fsummarize\u002Fextract\u002Fclassify\u002Frewrite\u002Fconverse over NL; debugging refusals\u002Fcutoffs\u002Fstreaming\u002Ftool-calls\u002Ftokens).\nSKIP only when another provider is being worked on (overrides all triggers): OpenAI\u002FGPT\u002FGemini\u002FLlama\u002FMistral\u002FCohere\u002FOllama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3213,3216,3217,3220,3222],{"name":3214,"slug":3215,"type":16},"Agents","agents",{"name":9,"slug":8,"type":16},{"name":3218,"slug":3219,"type":16},"Anthropic SDK","anthropic-sdk",{"name":3221,"slug":3208,"type":16},"Claude API",{"name":3223,"slug":3224,"type":16},"LLM","llm","2026-07-28T05:36:08.213335",{"slug":3227,"name":3227,"fn":3228,"description":3229,"org":3230,"tags":3231,"stars":3178,"repoUrl":3179,"updatedAt":3238},"doc-coauthoring","co-author documentation and technical specs","Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3232,3235],{"name":3233,"slug":3234,"type":16},"Documentation","documentation",{"name":3236,"slug":3237,"type":16},"Technical Writing","technical-writing","2026-04-06T17:56:14.18897",{"slug":3240,"name":3240,"fn":3241,"description":3242,"org":3243,"tags":3244,"stars":3178,"repoUrl":3179,"updatedAt":3259},"docx","create and edit Word documents","Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3245,3248,3250,3253,3256],{"name":3246,"slug":3247,"type":16},"Documents","documents",{"name":3249,"slug":3240,"type":16},"DOCX",{"name":3251,"slug":3252,"type":16},"Office","office",{"name":3254,"slug":3255,"type":16},"Templates","templates",{"name":3257,"slug":3258,"type":16},"Word","word","2026-07-18T05:16:23.136271",{"slug":3261,"name":3261,"fn":3262,"description":3263,"org":3264,"tags":3265,"stars":3178,"repoUrl":3179,"updatedAt":3279},"frontend-design","design production-grade frontend interfaces","Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3266,3267,3270,3273,3276],{"name":3170,"slug":3171,"type":16},{"name":3268,"slug":3269,"type":16},"Frontend","frontend",{"name":3271,"slug":3272,"type":16},"React","react",{"name":3274,"slug":3275,"type":16},"Tailwind CSS","tailwind-css",{"name":3277,"slug":3278,"type":16},"UI Components","ui-components","2026-04-06T17:56:16.723469",{"slug":3281,"name":3281,"fn":3282,"description":3283,"org":3284,"tags":3285,"stars":3178,"repoUrl":3179,"updatedAt":3293},"internal-comms","write internal company communications","A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3286,3289,3290],{"name":3287,"slug":3288,"type":16},"Communications","communications",{"name":3254,"slug":3255,"type":16},{"name":3291,"slug":3292,"type":16},"Writing","writing","2026-04-06T17:56:20.695522",{"slug":3295,"name":3295,"fn":3296,"description":3297,"org":3298,"tags":3299,"stars":3178,"repoUrl":3179,"updatedAt":3308},"mcp-builder","build MCP servers","Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node\u002FTypeScript (MCP SDK).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3300,3301,3304,3305],{"name":3214,"slug":3215,"type":16},{"name":3302,"slug":3303,"type":16},"API Development","api-development",{"name":3223,"slug":3224,"type":16},{"name":3306,"slug":3307,"type":16},"MCP","mcp","2026-04-06T17:56:10.357665",{"slug":3205,"name":3205,"fn":3310,"description":3311,"org":3312,"tags":3313,"stars":3178,"repoUrl":3179,"updatedAt":3316},"read edit and manipulate PDF files","Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text\u002Ftables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting\u002Fdecrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3314,3315],{"name":3246,"slug":3247,"type":16},{"name":3204,"slug":3205,"type":16},"2026-04-06T17:56:02.483316",{"slug":3318,"name":3318,"fn":3319,"description":3320,"org":3321,"tags":3322,"stars":3178,"repoUrl":3179,"updatedAt":3329},"pptx","create and edit PowerPoint presentations","Use this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3323,3326],{"name":3324,"slug":3325,"type":16},"PowerPoint","powerpoint",{"name":3327,"slug":3328,"type":16},"Presentations","presentations","2026-07-18T05:16:24.1471",{"slug":3331,"name":3331,"fn":3332,"description":3333,"org":3334,"tags":3335,"stars":3178,"repoUrl":3179,"updatedAt":3345},"skill-creator","create and optimize agent skills","Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3336,3337,3338,3341,3344],{"name":3214,"slug":3215,"type":16},{"name":3233,"slug":3234,"type":16},{"name":3339,"slug":3340,"type":16},"Evals","evals",{"name":3342,"slug":3343,"type":16},"Performance","performance",{"name":3236,"slug":3237,"type":16},"2026-04-19T06:45:40.804",490,{"items":3348,"total":3457},[3349,3365,3384,3399,3413,3430,3444],{"slug":3350,"name":3350,"fn":3351,"description":3352,"org":3353,"tags":3354,"stars":26,"repoUrl":27,"updatedAt":3364},"asana-api","manage Asana tasks and projects","Read and manage Asana tasks, projects, sections, comments, and workspaces. Use this whenever the user wants to list or search tasks, create or update a task, complete a task, comment on a task, move tasks between projects or sections, look up a project or workspace, or ask \"what's on my Asana list\" — even if they don't say \"API\". Also use it for any app.asana.com URL or an Asana task\u002Fproject gid. Always start from this skill when interacting with this service — its bundled scripts and recipes are the fastest path.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3355,3358,3361],{"name":3356,"slug":3357,"type":16},"Productivity","productivity",{"name":3359,"slug":3360,"type":16},"Project Management","project-management",{"name":3362,"slug":3363,"type":16},"Task Management","task-management","2026-06-24T07:44:51.70496",{"slug":3366,"name":3366,"fn":3367,"description":3368,"org":3369,"tags":3370,"stars":26,"repoUrl":27,"updatedAt":3383},"bigquery-api","run SQL queries against BigQuery","Run SQL against Google BigQuery and browse its catalog — submit queries (sync or async), poll job status, page through results, list datasets\u002Ftables, and read table schemas. Use this whenever the user wants to query a BigQuery table, ask \"what's in this dataset\", check a BigQuery job's status, or mentions bigquery.googleapis.com or a `project.dataset.table` path. Always start from this skill when interacting with this service — its bundled scripts and recipes are the fastest path.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3371,3374,3377,3380],{"name":3372,"slug":3373,"type":16},"Data Analysis","data-analysis",{"name":3375,"slug":3376,"type":16},"Database","database",{"name":3378,"slug":3379,"type":16},"Google Cloud","google-cloud",{"name":3381,"slug":3382,"type":16},"SQL","sql","2026-06-24T07:45:14.797877",{"slug":3385,"name":3385,"fn":3386,"description":3387,"org":3388,"tags":3389,"stars":26,"repoUrl":27,"updatedAt":3398},"config-guide","configure Claude agent settings and scopes","Reference guide for configuring @Claude agents — agents, agent scopes, identity profiles, presets, connections, rules, GitHub repositories, and custom instructions. Explains the inheritance model and configuration best practices.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3390,3391,3392,3395],{"name":3214,"slug":3215,"type":16},{"name":3221,"slug":3208,"type":16},{"name":3393,"slug":3394,"type":16},"Configuration","configuration",{"name":3396,"slug":3397,"type":16},"GitHub","github","2026-06-25T07:41:36.617524",{"slug":3400,"name":3400,"fn":3401,"description":3402,"org":3403,"tags":3404,"stars":26,"repoUrl":27,"updatedAt":3412},"confluence-api","manage Confluence Cloud content","Read, search, and manage Confluence Cloud pages, spaces, blog posts, comments, attachments, and labels. Use this whenever the user wants to find a page, read a doc, search the wiki with CQL, create or update a page, add a comment, list pages in a space, pull an attachment, or ask \"what does the wiki say about X\" — even if they don't say \"API\". Also use it for any *.atlassian.net\u002Fwiki URL, or a CQL string when the context is wiki content rather than tickets. Always start from this skill when interacting with this service — its bundled scripts and recipes are the fastest path.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3405,3408,3409],{"name":3406,"slug":3407,"type":16},"Confluence","confluence",{"name":3233,"slug":3234,"type":16},{"name":3410,"slug":3411,"type":16},"Knowledge Management","knowledge-management","2026-06-25T07:41:43.531982",{"slug":3414,"name":3414,"fn":3415,"description":3416,"org":3417,"tags":3418,"stars":26,"repoUrl":27,"updatedAt":3429},"datadog-api","manage Datadog monitoring and telemetry","Query and manage Datadog monitoring data — logs, metrics, monitors, dashboards, events, SLOs, traces, and incidents. Use this whenever the user wants to search logs, look at a metric, check which monitors are alerting, investigate a trace, pull SLO status, mute an alert, or ask \"what's happening in Datadog\" — even if they don't say \"API\". Also use it for any URL under *.datadoghq.com. Always start from this skill when interacting with this service — its bundled scripts and recipes are the fastest path.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3419,3420,3423,3426],{"name":3302,"slug":3303,"type":16},{"name":3421,"slug":3422,"type":16},"Datadog","datadog",{"name":3424,"slug":3425,"type":16},"Monitoring","monitoring",{"name":3427,"slug":3428,"type":16},"Observability","observability","2026-06-24T07:46:42.266372",{"slug":3431,"name":3431,"fn":3432,"description":3433,"org":3434,"tags":3435,"stars":26,"repoUrl":27,"updatedAt":3443},"debug-plugins","diagnose Claude plugin loading failures","Diagnose why a plugin or skill configured in @Claude admin settings isn't loading. Checks mount directories, the Claude Code launch command, and startup logs from inside the running container, then explains what failed and how to fix it.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3436,3437,3440],{"name":3221,"slug":3208,"type":16},{"name":3438,"slug":3439,"type":16},"Debugging","debugging",{"name":3441,"slug":3442,"type":16},"Plugin Development","plugin-development","2026-06-24T07:46:32.792809",{"slug":3445,"name":3445,"fn":3446,"description":3447,"org":3448,"tags":3449,"stars":26,"repoUrl":27,"updatedAt":3456},"enterprise-search","search company enterprise knowledge index","Search the company's enterprise knowledge index. Use this FIRST when starting any task that touches company-specific context - projects, people, policies, internal docs, prior decisions - before searching individual sources like Drive, Slack, or Jira directly. Also use it when the user asks \"do we have a doc about X\", \"what's our policy on Y\", or references internal initiatives by name. Always start from this skill when interacting with this service — its bundled scripts and recipes are the fastest path.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3450,3452,3453],{"name":3451,"slug":3445,"type":16},"Enterprise Search",{"name":3410,"slug":3411,"type":16},{"name":3454,"slug":3455,"type":16},"Research","research","2026-06-24T07:46:40.641837",18]