Integrations

Lookup Crm Contacts By Email

Find existing CRM contacts by email address. READS ONLY.

POST because a list of emails is a body, not because it changes anything - and it is tiered read for that reason, so a key granted "read my CRM" can call it. This is the de-duplication check to run BEFORE a create.

post/integrations/crm/connections/{connection_id}/batch/contacts/lookup-by-email

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/integrations/crm/connections/{connection_id}/batch/contacts/lookup-by-email
  • Auth: HTTP bearer

Path parameters

connection_idstring required

The CRM connection to act through.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

emailsstring[] required

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.