There's a new version of the HubSpot API

Check out the new API
View Beta Docs

We're also working on a new documentation website, you're invited to check it out and give us your feedback.

Delete multiple associations between CRM objects

Last updated January 7, 2025

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.

About

Jobs

Learn Inbound

Support

Locations

HubSpot, Inc.
25 First Street, 2nd Floor
Cambridge, MA 02141
European Headquarters
Ground Floor, Two Dockland Central
Guild Street, Dublin 1
Asia/Pacific Office
20 Hunter St, Level 7
Sydney NSW 2000
View our other locations
Example PUT URL: https://api.hubapi.com/crm-associations/v1/associations/delete-batch Example PUT JSON, removing the associations of two contacts from a single ticket: [ { "fromObjectId": 496346, "toObjectId": 176602, "category": "HUBSPOT_DEFINED", "definitionId": 15 }, { "fromObjectId": 491646, "toObjectId": 176602, "category": "HUBSPOT_DEFINED", "definitionId": 15 } ] Returns a 204 No Content response on success.