Create video host for user

Testing

POST

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

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

OperationId:CreateIotumVideoHostForUser

Creates a video host for a user, so the user can host video conferences, and links it to the user.

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. Only Office Manager scope or higher can set plan_slug or role.

The domain must have a video account that is not suspended. Otherwise the request returns 400 with Not Able to make request. A user that does not exist returns 404. A user that already has a video host returns 409: change it with PUT instead. Fields you leave out are filled from the user: name from the first and last name, email from the first email address, and the language from the user's language when the video portal supports it. The video service sends no welcome email unless you ask for one. Add-ons cannot be set. The host is created at once, and linking it to the user 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 does the same.

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 video host is created. Linking it to the user is applied shortly after.

Bodyapplication/json

🟠400Bad Request

🟠401Authentication Required

🟠403Forbidden

🟠404Record not found

🟠409Conflict

🔴500Server Error

🔴502Bad Gateway

🔴504Gateway Timeout

Request Example

Shell

JavaScript

Java

Swift

cURL

Defaults from the userName, email, and waiting roomDomain's default plan

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//host' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'

Response Example

202 - Accepted

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

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

List available video products

Add video contacts for user