Skip to main content
POST
Create CRM sync

Authorizations

Authorization
string
header
required

API key (fam_..., created under Settings → API Keys) or an OAuth 2.0 access token (fam_at_...). Keys can be restricted to scopes such as assistants:read, calls:write, campaigns:write, automations:read, dashboards:read, dashboards:write, leads:write, segments:write, phone_numbers:write, sip_trunks:write, knowledge:write, voices:read, billing:read, settings:write, platform:read, platform:write; a *:write scope implies the matching *:read. Automation and dashboard endpoints also accept the legacy calls:* scope. Keys without scope restrictions have full access.

Body

application/json
connection_id
string<uuid>
required
name
string
required
Required string length: 1 - 128
object_type
string
required
Required string length: 1 - 128
field_mapping
object
required

External source to Audience target. A bare key keeps legacy 1:1 behavior. To combine fields or fixed text, use non-evaluated {{field}} tokens in one source expression, for example {{salutation}} {{firstName}} {{lastName}} or +49{{phone}}. At least one target must be phone or email, and each target appears once.

Example:
selection
object

Provider-neutral source selection. Discovered list/view/filter IDs use sourceId. Set default_phone_country to a supported ISO-2 code (for example DE) to normalize national phone numbers; international +/00 values take priority. Required provider fields are derived from the mapping.

interval_minutes
integer
default:60
Required range: 5 <= x <= 10080
null_policy
enum<string>
default:ignore
Available options:
ignore,
clear
removal_policy
enum<string>
default:deactivate_membership
Available options:
deactivate_membership,
keep
conflict_policy
enum<string>
default:review
Available options:
review,
skip

Response

Created CRM sync.