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.
Note: This endpoint is deprecated. Use the CRM Associations API to manage deal associations.
HTTP Methods:
DELETE
Response Format:
N/A
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
CRM
Deletes the association between an existing deal and a contact or company. The association can be removed from either contacts or companies with each request. This endpoint supports deleting the association for more than one object IDs of a particular object type at once.
| 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. |
| Deal Id | Used in the request URL (see above) | Unique identifier for a particular deal. This id is available in the URL of a deal in HubSpot CRM. |
| Object Type | Specify whether you would like to delete the association from either a contact or a company. Must be all caps (CONTACT or COMPANY). | The type of object that you are removing the association from. |
| Contact or company IDs | Specify a contact or company ID (&id=X) | Unique identifier for a particular contact or company. These IDs are available in the URL of a contact or company in HubSpot CRM. |
| Optional Parameters | How to use | Description |
|---|---|---|
| Additional contact or company IDs | You can specify more than one contact or company id in each request (&id=X) | Unique identifier for a particular contact or company. These IDs are available in the URL of a contact or company in HubSpot CRM. |
