Update user contact

PUT

/domains/{domain}/users/{user}/contacts/{contact_id}

Last modified:2026-10-09 00:37:59

OperationId:UpdateContactForUser

Changes a contact in a user's personal address book. Send only the fields to change; the others keep their values.

Basic User, Advanced User, Simple User, Call Center Agent, and Call Center Supervisor can update their own contacts only. Site Manager can update its own contacts and those of users at its own site. Office Manager can update the contacts of any user in its domain, Reseller those of users in domains of its territory, and Super User any user's. A request for any other address book returns 403.

The ID must name a contact in the user's personal address book or one of the domain's shared contacts; any other ID returns 404. Changing a shared contact this way needs the same rights as PUT /domains/{domain}/contacts/{contact_id}: domain tier or above, or 403. is-favorite sets or clears the favorite mark. groups replaces the contact's groups with the ones you send; send [] to take it out of every group. avatar is ignored; change the picture with PUT /domains/{domain}/users/{user}/contacts/{contact_id}/avatar.

A tags value containing shared also sends the update to the domain's shared contacts, with the same rights check.

202 means the change was accepted and is applied shortly after, so a read right away can still show the old values.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

The change was accepted. It is applied shortly after.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠404Record not found

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

cURL

Change work numberMark favorite and file

curl --location --request PUT 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//contacts/5f2b7c9e1a4d8e3b6c0f9a2d7e1b4c8a' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "phonenumber-work": "15555550102"
}'

Response Example

202 - Accepted

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-10-09 00:37:59

Read user contact

Delete user contact