Removes a deal's association with a contact or company

DELETE deals/v1/deal/:dealId/associations/:OBJECTTYPE?id=:objectId&id=:objectId

Method Details

HTTP Methods:

DELETE

Response Format:

N/A

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

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 ParametersHow to useDescription
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.