Add video contacts for user

Testing

POST

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

Last modified:2026-10-09 00:43:40

OperationId:CreateIotumVideoHostContactsForUser

Adds contacts to a user's video address book, so the user can invite them to video conferences. Send a JSON array with one object per contact.

Requires a token for this user. Office Manager, Reseller, and Super User can change the video host of any user in a domain they manage.

The domain must have a video account that is not suspended. Otherwise the request returns 400 with Not Able to make request. The user must have a video host. Every contact needs a name. To link a contact to one in the user's platform contacts, include that contact's contact_id: the link is applied shortly after. When the video service rejects a value you sent, the request returns 400 with the service's message. When the video service fails or does not answer, it returns 502 or 504. POST /domains/{domain}/users/{user}/video/contacts does the same. PUT and DELETE on this path return 405.

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 contacts are added to the user's video address book.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

🔴500Server Error

🔴502Bad Gateway

🔴504Gateway Timeout

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//host/contacts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "name": "Front Desk",
        "email": "frontdesk@example.com",
        "business_phone": "15555550100"
    },
    {
        "name": "Support Line",
        "email": "support@example.com",
        "time_zone": "America/Chicago",
        "contact_id": "0c4e8a2f6b1d9e3a7c5f0b8d2e6a4c1f"
    }
]'

Response Example

202 - Accepted

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

Modified at 2026-10-09 00:43:40

Create video host for user

Create video subscription