Integrations

Create Crm Deal

Create a deal IN THE CUSTOMER'S CRM.

post/integrations/crm/connections/{connection_id}/deals

Request

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

Path parameters

connection_idstring required

The CRM connection to act through.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

namestring required
amountnumber nullable
stagestring nullable

Provider's pipeline stage. Omit to take the provider's default stage.

probabilitynumber nullable
close_datestring nullable

ISO 8601 date.

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.