Associate CRM objects

HTTP Methods:

PUT

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Headers

Products:

Marketing & CRM

crm.objects.companies.write
crm.objects.contacts.write
crm.objects.deals.write
tickets
e-commerce

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.

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

Required parameters	How to use	Description
OAuth access token or private app access token	Authorization: Bearer {token} header	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.

Developers