Skip to main content
POST
Create a contact

Authorizations

X-API-Key
string
header
required

API key (sk_xxx) from Developer Settings. No X-Account-ID needed.

Headers

x-account-id
string | null

Body

application/json
first_name
string | null
Maximum string length: 150
last_name
string | null
Maximum string length: 150
full_name
string | null
Maximum string length: 300
emails
phones
mobile_phone
string | null
job_title
string | null
department
string | null
linkedin_url
string | null
twitter_url
string | null
twitter_handle
string | null
facebook_url
string | null
instagram_url
string | null
description
string | null
address
string | null
location
Location · object
metadata
Metadata · object
enrichment
Enrichment · object
enrichment_provider
string | null
enrichment_last_updated
string<date-time> | null
enrichment_status
string | null
last_interaction
string<date-time> | null
date_of_birth
string<date> | null
notes
string | null
categories
string[] | null
company_id
string<uuid> | null
custom_fields
Custom Fields · object | null
associated_deal_ids
string<uuid>[] | null

Deal IDs to associate with contact

Response

Successful Response

id
string<uuid>
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
account_id
string<uuid>
required
first_name
string | null
Maximum string length: 150
last_name
string | null
Maximum string length: 150
full_name
string | null
Maximum string length: 300
emails
phones
mobile_phone
string | null
job_title
string | null
department
string | null
linkedin_url
string | null
twitter_url
string | null
twitter_handle
string | null
facebook_url
string | null
instagram_url
string | null
description
string | null
address
string | null
location
Location · object
metadata
Metadata · object
enrichment
Enrichment · object
enrichment_provider
string | null
enrichment_last_updated
string<date-time> | null
enrichment_status
string | null
last_interaction
string<date-time> | null
date_of_birth
string<date> | null
notes
string | null
categories
string[] | null
company_id
ReferenceItem · object | null

Company with id and name

custom_fields
Custom Fields · object | null
associated_deal_ids
ReferenceItem · object[] | null

Associated deals with id and name

name
string | null
is_favorite
boolean
default:false

Whether this record is favorited by the current user