Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Send your API key as Authorization: Bearer YOUR_API_KEY.

Path Parameters

locationId
string
required

The sub-account's stable location id.

Minimum string length: 1

Body

application/json

The lead.

One lead. phone is required; everything else is optional. Fields nested one level under contact, data or lead are read as well, for senders that wrap the lead. Arrays and deeper objects are ignored.

phone
string
required

The lead's number, in E.164 format. A North American number without a country code is completed. phone_number and mobile are read as this field.

Example:

"+13125550142"

first_name
string

The lead's first name, up to 100 characters.

Example:

"Ana"

last_name
string

The lead's last name, up to 100 characters.

Example:

"Diaz"

name
string

A full name, split into first and last when the two are not sent.

Example:

"Ana Diaz"

email
string

A valid email address, up to 254 characters. It is saved in lower case.

Example:

"ana@example.com"

timezone
string

IANA zone. Decides when the lead may be called.

Example:

"America/Chicago"

address1
string

Street address, up to 200 characters.

Example:

"1 Main St"

city
string

City, up to 200 characters.

Example:

"Chicago"

state
string

State or region, up to 200 characters.

Example:

"IL"

postalCode
string

Postal or ZIP code, up to 200 characters.

Example:

"60601"

{key}

Any of the sub-account's custom fields, by its key or its name. A field the sub-account does not have is ignored and named in ignoredFields.

Response

A contact with that number already existed and was updated.

success
boolean
required
data
object
required