Reminder: As of August 9th, the demo API key will only be allowed to make GET requests. Please see the announcement for more details.

Delete an association

Last updated May 14, 2019

PUT /crm-associations/v1/associations/delete

Method Details

HTTP Methods:


Content Type:


Response Format:


Requires Authentication?


Rate Limited?





Marketing & CRM

Required Scope:


Delete an association between 2 CRM objects.

If you need to remove multiple associations, you can use the batch delete endpoint.

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 you want to remove the association from.
To object "toObjectId":
Used in the request JSON
The ID of the currently associated object that you're removing the association from.
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 those IDs.