Integrations

Update Crm Deal

Partially update a CRM deal. Omitted fields are left alone.

Moving stage is what closes a deal in most CRMs, and it can fire that provider's own workflows and notifications.

put/integrations/crm/connections/{connection_id}/deals/{deal_id}

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/integrations/crm/connections/{connection_id}/deals/{deal_id}
  • Auth: HTTP bearer

Path parameters

connection_idstring required

The CRM connection to act through.

deal_idstring required

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

namestring nullable
amountnumber nullable
stagestring nullable
probabilitynumber nullable
close_datestring nullable
typestring nullable
descriptionstring nullable
company_idstring nullable
contact_idstring nullable
user_idstring nullable

Response

Successful Response

dataCrmPayload required

One CRM record, or one provider response.

Open-shaped ON PURPOSE. These bodies carry whatever the provider returned, the field set differs between HubSpot, Salesforce, Pipedrive and SugarCRM, and it grows every time one of them ships something. Pinning it would drop whatever a provider reported that this contract had not caught up on - which on a CRM surface means silently hiding the customer's own data from them.

Changes

No recorded changes to this operation across all 2 revisions of this API.