There's a new version of the HubSpot API

Starting November 30, 2022, API keys will be sunset as an authentication method. Learn more about this change and how to migrate an API key integration to use a private app instead.

Associate CRM objects

Last updated June 17, 2020

PUT /crm-associations/v1/associations

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:


This endpoint is used to associate two CRM objects.

Use case for this endpoint: You can use this endpoint to associate a ticket with a contact or to associate a line item with a deal.

See all possible associations on the CRM Associations Overview.

If you need to make multiple associations (either to the same object or across multiple objects) you can use the batch associations endpoint.

Response details

If the request is successful, returns a 204 No Content response.

Required parameters How to use Description
OAuth access token or API key Authorization: Bearer {token} header or hapikey={key} query parameter. Used to authenticate the request. Please see this page for more details about authentication.
From object "fromObjectId":
Used in the request JSON
The ID of the object being associated.
To object "toObjectId":
Used in the request JSON
The ID of the object the from object is being associated with.
Category "category":
Used in the request JSON
The category of the association. Currently this must be "HUBSPOT_DEFINED"
Association definition "definitionId":
Used in the request JSON
The ID of the association definition. See the table on the overview page for a list of these IDs.

These code samples use a demo API key. Using this key for anything but GET requests will result in an error. For all other requests (such as POST or PUT), you'll need to use your own API key or OAuth. For more details, please see here