There's a new version of the HubSpot API
As of November 30, 2022, HubSpot API Keys are being deprecated and are no longer supported. Continued use of HubSpot API Keys is a security risk to your account and data. Your API Keys could be deactivated at any time after Nov. 30th, and we recommend that you migrate to Private Apps as soon as possible so you do not lose business-critical functionality.
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. |
