Delete user contact

DELETE

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

Last modified:2026-10-09 00:38:02

OperationId:DeleteContactForUser

Removes a contact from a user's address book, together with its avatar.

Basic User, Advanced User, Simple User, Call Center Agent, and Call Center Supervisor can delete their own contacts only. Site Manager can delete its own contacts and those of users at its own site. Office Manager can delete 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. Deleting a shared contact this way needs the same rights as DELETE /domains/{domain}/contacts/{contact_id}: domain tier or above, or 403. 202 means the delete was accepted and is applied shortly after. When the user has video meetings, the contact is also removed from their video contact list.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢202Accepted

application/json

The delete was accepted. It is applied shortly after.

Bodyapplication/json

🟠404Record not found

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//contacts/5f2b7c9e1a4d8e3b6c0f9a2d7e1b4c8a' \
--header 'Authorization: Bearer <token>'

Response Example

202 - Accepted

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

Modified at 2026-10-09 00:38:02

Update user contact

Count user contacts