Update a contact

Changes the fields sent and leaves the others as they are. null clears a text field.

Lists replace the whole list. If you send phones, emails, addresses or tags, what you send becomes the contact's list. Each phone, e-mail and address is complete as sent: an omitted extension means none and primary false. Keep an item's id to keep that item; one without an id is added. To add a phone, take the list you read, append the new phone, and send the whole list.

Concurrent changes: send If-Match with the etag you read. If someone changed the contact since, nothing is changed and the answer is 412: read it again, apply your change to what you read, and send it again.

owner_id and private need permissions.change_access when they change (sent as they are, they need nothing); everything else needs permissions.edit. When the change leaves you unable to see the contact (made private to someone else), data is null.

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

The contact's id.

Query Params
uuid

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

Body Params
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
Headers
string

The etag you read, or the ETag header as you received it (with or without a W/ prefix). If the contact changed since, nothing is changed and the answer is 412 precondition_failed. Editors should always send it.

Responses

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