Skip to main content
POST
Create or upsert contact

Authorizations

Authorization
string
header
required

Company API Key

Body

application/json

Contact fields

full_name
string

Title-cased; split into first and last name

email
string

Lowercased; optional

phone_number
string

Normalized using the company's country when present

business_name
string
notes
string
tags
string[]

A list, or a comma-separated string. On an existing contact, new tags are merged with existing tags (deduplicated)

is_dnd

Do-not-disturb; boolean or string variants accepted

lead_source
string

Must be one of: manual, api, webhook, facebook, instagram, import. Invalid values are stored as manual.

custom_fields
object

Custom field values keyed by the field's name (e.g. equity_percentage), not its label. Keys that don't match a custom field on the company are skipped. Contacts have no built-in city or address fields: store those as custom fields.

Example:

Response

Success. Empty response body (no JSON payload).