Integrations

Get Or Create Crm Audience

Get, or create, the graph8 audience a CRM import lands in.

IDEMPOTENT BY TITLE. Calling twice with the same list_name returns the same audience with created: false rather than making a second one, which is what makes it safe to call before every import. That is the difference from POST /lists, which always creates - and it is why this exists separately rather than being folded into it.

The audience is tagged with the CRM provider and the connection it came from, so a later sync can tell CRM-imported rows from graph8-native ones.

200, not 201: most calls return a list that already existed.

post/integrations/crm-sync/audiences

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/integrations/crm-sync/audiences
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

list_namestring required

Audience title. Matched exactly; reused when it exists.

connection_idstring required

The CRM connection this audience is for. Its provider is recorded on the audience as the source and as a crm-import tag, which is what lets a later sync tell CRM-imported rows from graph8-native ones.

entity_typestring nullable

contacts, companies, deals or leads. Singular forms are accepted and pluralised by the app; anything unrecognised falls back to contacts. Omit for contacts.

Response

Successful Response

Changes

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