Associate a deal with a contact or company

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

Method Details

HTTP Methods:

PUT

Content Type:

application/json

Response Format:

N/A

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

CRM

Updates the association between an existing deal and a contact or company. The deal can be associated with either contacts or companies with each request. This endpoint supports associating 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 associate the deal with a contact or a company. Must be all caps (CONTACT or COMPANY). The type of object that you are associating the deal with.
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.