Create labeled associations between HubSpot CRM objects using Associations API v4

domain: developers.hubspot.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Define a custom association label via POST to /crm/v4/associations/{fromObjectType}/{toObjectType}/labels with a label string and an optional inverseLabel for the reverse direction
  2. Note the returned typeId values for both directions of the label — you will need these when creating association records
  3. Create an association with a specific label by POST to /crm/v4/objects/{fromObjectType}/{fromObjectId}/associations/{toObjectType}/{toObjectId} with a JSON body containing an associationTypes array where each entry specifies associationCategory (HUBSPOT_DEFINED or USER_DEFINED) and associationTypeId
  4. Retrieve all associations with their labels for a given object via GET /crm/v4/objects/{objectType}/{objectId}/associations/{toObjectType}; the response includes label metadata alongside each association
  5. To batch-create labeled associations, POST to /crm/v4/associations/{fromObjectType}/{toObjectType}/batch/create with an inputs array where each entry specifies from.id, to.id, and the associationTypes array
  6. Remove a specific label from an association without deleting the association entirely by using the label-specific DELETE endpoint rather than the full association DELETE

Known gotchas

Related routes

Create and read associations between HubSpot CRM objects using Associations API v4
developers.hubspot.com · 5 steps · unrated
Use HubSpot's CRM Associations API v4 to define a custom association type between two standard objects, create labeled associations in bulk, and query associations with label filters
hubspot.com · 5 steps · unrated
Create labeled v4 associations between two custom objects in HubSpot
developers.hubspot.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans