Accounts
Create operator accounts. Requires the accounts:admin scope (admin API key or
admin OAuth client).
Create account
POST /api/v1/accounts — scope accounts:admin
| Body field | Type | Required |
|---|---|---|
email |
string (valid email) | yes |
name |
string | no |
password |
string | no (ignored by sandbox) |
phone |
string | no |
timeZone |
string | no (default UTC) |
country |
string | no |
region |
string | no |
roleId |
int | no |
curl -X POST https://api.kiosk-x.ai/api/v1/accounts \
-H "X-API-Key: vtm_kioskx_admin_5f2a9c1d8e7b4a3f" \
-H "Content-Type: application/json" \
-d '{"email": "newoperator@example.com", "name": "New Operator", "timeZone": "America/Chicago", "country": "US", "region": "TX"}'
{
"code": 200, "message": "success",
"data": {
"id": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
"email": "newoperator@example.com",
"name": "New Operator",
"phone": null,
"timeZone": "America/Chicago",
"country": "US",
"region": "TX",
"createdAt": "2026-08-10T22:41:00.000+0000"
}
}
Failure modes:
| Code | When |
|---|---|
400 |
invalid email, duplicate account |
403 |
key lacks accounts:admin |