There's a new version of the HubSpot API

As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.

Delete multiple associations between CRM objects

Last updated May 15, 2023

PUT /crm-associations/v1/associations/delete-batch

Method Details

HTTP Methods:

PUT

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing & CRM

Required Scope:

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

Delete multiple associations between CRM objects.

The JSON data in the PUT request will be a list of items each representing a single association that you want to delete. See the example for more details.

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 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.