Create user contact - NetSapiens API v2

Adds a contact to a user's personal address book, and to their video contact list when they have video meetings. Every scope except No Portal can change its own address book, and Site Manager, Office Manager, Reseller, and Super User can also change those of the users they administer.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200OK

application/json

The contact as stored, or as sent when the write has not applied within 2 seconds, with its unique-id. In that case, read the contact again shortly after.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠404Record not found

🟠403Forbidden

🟠409Conflict

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//contacts' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "name-first-name": "Front", "name-last-name": "Desk", "company": "Example Supply Co", "email": "frontdesk@example.com", "phonenumber-work": "15555550100", "phonenumber-cell": "15555550101", "notes": "Deliveries before noon", "is-favorite": true, "groups": [ "Vendors" ] }'

{ "unique-id": "5f2b7c9e1a4d8e3b6c0f9a2d7e1b4c8a", "name-first-name": "Front", "name-middle-name": "", "name-last-name": "Desk", "company": "Example Supply Co", "email": "frontdesk@example.com", "phonenumber-work": "15555550100", "phonenumber-cell": "15555550101", "phonenumber-home": "", "phonenumber-fax": "", "notes": "Deliveries before noon", "avatar": "", "created-datetime": "2026-09-01T14:30:00+00:00", "domain": "example.com", "is-shared": false, "is-favorite": true, "groups": [ "Vendors" ] }