Integrations

Create Crm Lead

Create a Lead IN THE CUSTOMER'S SALESFORCE.

last_name and company are required by Salesforce itself. status is an OPEN picklist - read the valid values from GET /integrations/crm-sync/leads/statuses first, because an invented one is stored rather than refused.

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

Request

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

Path parameters

connection_idstring required

The CRM connection to act through.

Headers

Authorizationstring nullable

X-Target-Org-Idstring nullable

Request body

first_namestring nullable

last_namestring required

emailstring nullable

phonestring nullable

titlestring nullable

companystring required

statusstring nullable

Salesforce Lead.Status API name. Read the valid values from GET /integrations/crm-sync/leads/statuses - it is an OPEN picklist, so an invented value silently becomes a real status.

lead_sourcestring nullable

industrystring nullable

websitestring nullable

employee_countinteger nullable

annual_revenuenumber 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.