Create a contact

Creates a contact from the fields sent; at least a name, a company or a phone. Everything in the request is saved together, so a private contact is never visible to anyone else, even for a moment.

Safe retries: send your own id (a UUID you generate). The same create sent again, after a timeout for example, answers 409 contact_exists instead of creating a second contact; read it with its id.

The contact is owned by the person creating it, or by owner_id. Saving numbers merges in the contacts that were created automatically for those numbers and never saved: their calls, texts and voicemails move to the new contact, and meta.folded_contact_ids lists them so you can forget those ids.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
uuid

For EMAK staff only: the account to read. Everyone else reads their own account and must leave it out.

Body Params
uuid

Your own id for the contact, so a retry can't create it twice.

string
length ≤ 201

A full name as one string (Marie-Ève Tremblay Roy). EMAK splits it into first and last name the way the web app does (a name of three words or more may be sent to Google to find where the first name ends) and clears display_name; a contact known only by its company has its company renamed instead. Not with the other name fields; on a change, not with company either (on a create, company is kept as sent).

string | null

First name.

string | null

Last name.

string | null

A name shown in place of the first and last name, when set.

string | null

The company the contact works for, or the business's name.

string | null

Job title.

phones
array of objects
length ≤ 50

The whole list: what you send becomes the contact's list.

phones
emails
array of objects
length ≤ 50

The whole list.

emails
addresses
array of objects
length ≤ 50

The whole list.

addresses
tags
array of strings
length ≤ 100

The whole set of tag names.

tags
boolean
boolean
uuid

A person of your organization.

boolean
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json