Users
List a collection of users.
Use the filter query parameter to retrieve just a subset of a collection.
Use the search query parameter to restrict the results of a request to match a search criterion.
Use the orderby query parameter to specify the sort order of the items returned from server.
The default order is ascending order.
Use the skip query parameter to set the number of items to skip at the start of a collection.
0Use the top query parameter to specify the page size of the result set.
100OK
Error
GET /api/users HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"count": 100,
"items": [
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"name": "text",
"enabled": true,
"email": "[email protected]",
"display_name": "text",
"role": "User",
"mobile_phone": "text",
"work_phone": "text",
"home_phone": "text",
"address": "text",
"department": "text",
"extension_number": "text",
"created_at": "2017-07-21T17:32:28Z",
"avatar_file_name": "text",
"avatar_file_size": 0,
"avatar_file_url": "/api/blobs/WexWdABcd5D4PDgzTKV3gAAAEu00WcK",
"sync_type": "Microsoft 365"
}
]
}Create a new user.
The user's account name.
Only letters, numbers, and the following special characters can be added: underscore, dash, single quote, and period (_, -, ', and .).
Username cannot start or end with period (.).
admin, system, administrator, and root are reserved names for system admin only with case ignored.
The password of user.
The email address of user.
The display name of user.
Allows temporarily disabling the extension.
trueRoles include built-in roles and custom roles.
Built-in roles roles cannot be modified.
Also, the names of built-in roles are reserved words,
custom roles are not allowed to use these names to avoid unnecessary confusion.
Built-in roles include:
SystemAdmin: the system administrator has almost all permissions.Replicator: the application permissions collection.Dealer: the sales manager has all sold tenant resource permissionsAdmin: the admin has all tenant-wide resource permissions.StandardUser: the user all user-wide resource permissions.StandardInternationalUser: the user all user-wide resource permissions with international call permissions.QueueManager: The call queue manager.
UserThe mobile phone number of user.
The office phone number of user.
The home phone number of user.
The address.
The department of user.
The extension number.
[0-9]{3,64}The extension password.
Records all calls and saves audio recordings on server.
falseRecords all calls and saves video recordings on server.
falseEnable Do Not Disturb or not.
Enable Automatic Callback or not.
Enable hot desking feature or not.
falseAlways make outbound anonymous calls or not.
falseThe preferred configuration for SMS/MMS.
Note: Only users with UserManagement::Users privilege can change this property.
DISABLE: Disable user SMS/MMS feature.ALLOW: Enable user SMS/MMS feature but with outbound caller ID.ALLOW_WITH_SENDER_ID: Enable user SMS/MMS but with trunk sender ID.
DISABLEPossible values: Always delivery outbound caller ID or not.
trueSome custom configuration options serialized as json string
BCP 47 Language Tags (The Internet Best Current Practices (BCP) for language tags). A language tag is composed of a sequence of one or more subtags such as language, region, variant and script subtags. When a language tag is comprised of more than one subtag, the subtag values are separated by the "-" character. You will most commonly find language tags written with 2 subtags - language and region. For example: en-US.
en-USWhether the PIN is required to access voice mail of extension.
trueThe PIN number for accessing.
The PIN policies include:
- A sequence of numbers 6-10 digits in length.
- No repeating numbers (e.g. "111", "222")
- No sequential numbers (e.g. "012", "789")
Enable voicemail to email notify.
falseAnnounces Date and Time of Message.
DISABLE: Do not read;12_HOUR_CLOCK: Read in 12-hour clock;24_HOUR_CLOCK: Read in 24-hour clock.
The interface type for QR code or auto provisioning.
Can be neither:
WEB_DOMAIN:PUBLIC_IPV4:PUBLIC_IPV6:PRIVATE_IPV4:PRIVATE_IPV6:SBC_DOMAIN:
The transport protocol:
Can be either:
UDP:TCP:TLS:
Created
Error
POST /api/users HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 3334
{
"name": "text",
"password": "text",
"email": "[email protected]",
"display_name": "text",
"enabled": true,
"role": "User",
"mobile_phone": "text",
"work_phone": "text",
"home_phone": "text",
"address": "text",
"department": "text",
"extension_number": "text",
"extension_password": "text",
"enable_audio_recording": false,
"enable_video_recording": false,
"enable_dnd": true,
"enable_acb": true,
"enable_hot_desking": false,
"anonymous_outbound_calls": false,
"sms": "DISABLE",
"delivery_outbound_cid": true,
"outbound_caller_ids": [
{
"provider_id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"caller_id": "text",
"description": "text"
}
],
"custom_options": "text",
"office_hours": {
"mode": "CUSTOM",
"monday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"tuesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"wednesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"thursday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"friday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"saturday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"sunday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
}
},
"available_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"available_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"available_no_answer_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text",
"timeout": 60
},
"busy_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"busy_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"busy_no_answer_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text",
"timeout": 60
},
"dnd_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"dnd_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"away_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"away_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"lunch_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"lunch_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"trip_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"trip_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"offline_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"offline_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"custom_forward_rules": [
{
"action": "FORWARD_TO_NUMBER",
"number": "text",
"caller_id": "text",
"type": "ALL_HOURS",
"hours": {
"monday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"tuesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"wednesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"thursday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"friday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"saturday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"sunday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
}
}
}
],
"voicemail_prompt": "en-US",
"enable_voicemail_pin": true,
"voicemail_pin": "text",
"enable_voicemail_notify": false,
"voicemail_play_datetime": "DISABLE",
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP",
"blfs": [
{
"key": "text",
"value": "text",
"first_name": "text",
"last_name": "text"
}
]
}{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw"
}Retrieves the settings of a user.
The unique ID of user.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYwOK
Error
GET /api/users/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"name": "text",
"email": "[email protected]",
"display_name": "text",
"role": "User",
"enabled": true,
"mobile_phone": "text",
"work_phone": "text",
"home_phone": "text",
"address": "text",
"department": "text",
"extension_number": "text",
"enable_audio_recording": false,
"enable_video_recording": false,
"enable_dnd": true,
"enable_acb": true,
"enable_hot_desking": false,
"anonymous_outbound_calls": false,
"delivery_outbound_cid": true,
"sms": "DISABLE",
"outbound_caller_ids": [
{
"provider_id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"caller_id": "text",
"description": "text"
}
],
"custom_options": "text",
"office_hours": {
"mode": "CUSTOM",
"monday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"tuesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"wednesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"thursday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"friday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"saturday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"sunday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
}
},
"available_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"available_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"available_no_answer_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text",
"timeout": 60
},
"busy_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"busy_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"busy_no_answer_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text",
"timeout": 60
},
"dnd_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"dnd_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"away_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"away_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"lunch_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"lunch_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"trip_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"trip_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"offline_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"offline_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"custom_forward_rules": [
{
"action": "FORWARD_TO_NUMBER",
"number": "text",
"caller_id": "text",
"type": "ALL_HOURS",
"hours": {
"monday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"tuesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"wednesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"thursday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"friday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"saturday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"sunday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
}
}
}
],
"voicemail_prompt": "en-US",
"enable_voicemail_pin": true,
"voicemail_pin": "text",
"enable_voicemail_notify": false,
"voicemail_play_datetime": "DISABLE",
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP",
"blfs": [
{
"key": "text",
"value": "text",
"first_name": "text",
"last_name": "text"
}
],
"profile": "NzAwNTUxOTA5NzczMTQ4MTYw",
"created_at": "2017-07-21T17:32:28Z",
"avatar_file_name": "text",
"avatar_file_size": 0,
"avatar_file_url": "/api/blobs/WexWdABcd5D4PDgzTKV3gAAAEu00WcK",
"sync_type": "Microsoft 365"
}Modify the settings of a user.
The unique ID of user.
The unique ID of the resource.
NzAwNTUxOTA5NzczMTQ4MTYwThe email address of user.
The display name of user.
Allows temporarily disabling the extension.
trueThe mobile phone number of user.
The office phone number of user.
The home phone number of user.
The address.
The department of user.
Records all calls and saves audio recordings on server.
falseRecords all calls and saves video recordings on server.
falseEnable Do Not Disturb or not.
Enable Automatic Callback or not.
Enable hot desking feature or not.
falseAlways make outbound anonymous calls or not.
falseAlways delivery outbound caller ID or not.
trueThe preferred configuration for SMS/MMS.
Note: Only users with UserManagement::Users privilege can change this property.
DISABLE: Disable user SMS/MMS feature.ALLOW: Enable user SMS/MMS feature but with outbound caller ID.ALLOW_WITH_SENDER_ID: Enable user SMS/MMS but with trunk sender ID.
DISABLEPossible values: Some custom configuration options serialized as json string
BCP 47 Language Tags (The Internet Best Current Practices (BCP) for language tags). A language tag is composed of a sequence of one or more subtags such as language, region, variant and script subtags. When a language tag is comprised of more than one subtag, the subtag values are separated by the "-" character. You will most commonly find language tags written with 2 subtags - language and region. For example: en-US.
en-USWhether the PIN is required to access voice mail of extension.
trueThe PIN number for accessing.
The PIN policies include:
- A sequence of numbers 6-10 digits in length.
- No repeating numbers (e.g. "111", "222")
- No sequential numbers (e.g. "012", "789")
Enable voicemail to email notify.
falseAnnounces Date and Time of Message.
DISABLE: Do not read;12_HOUR_CLOCK: Read in 12-hour clock;24_HOUR_CLOCK: Read in 24-hour clock.
The interface type for QR code or auto provisioning.
Can be neither:
WEB_DOMAIN:PUBLIC_IPV4:PUBLIC_IPV6:PRIVATE_IPV4:PRIVATE_IPV6:SBC_DOMAIN:
The transport protocol:
Can be either:
UDP:TCP:TLS:
OK
No content
Error
POST /api/users/{id} HTTP/1.1
Host: HOSTNAME:8887
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 3234
{
"email": "[email protected]",
"display_name": "text",
"enabled": true,
"mobile_phone": "text",
"work_phone": "text",
"home_phone": "text",
"address": "text",
"department": "text",
"enable_audio_recording": false,
"enable_video_recording": false,
"enable_dnd": true,
"enable_acb": true,
"enable_hot_desking": false,
"anonymous_outbound_calls": false,
"delivery_outbound_cid": true,
"sms": "DISABLE",
"outbound_caller_ids": [
{
"provider_id": "NzAwNTUxOTA5NzczMTQ4MTYw",
"caller_id": "text",
"description": "text"
}
],
"custom_options": "text",
"office_hours": {
"mode": "CUSTOM",
"monday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"tuesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"wednesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"thursday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"friday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"saturday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"sunday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
}
},
"available_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"available_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"available_no_answer_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text",
"timeout": 60
},
"busy_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"busy_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"busy_no_answer_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text",
"timeout": 60
},
"dnd_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"dnd_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"away_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"away_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"lunch_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"lunch_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"trip_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"trip_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"offline_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"offline_non_office_hours_forward_rule": {
"action": "FORWARD_TO_NUMBER",
"number": "text"
},
"custom_forward_rules": [
{
"action": "FORWARD_TO_NUMBER",
"number": "text",
"caller_id": "text",
"type": "ALL_HOURS",
"hours": {
"monday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"tuesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"wednesday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"thursday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"friday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"saturday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
},
"sunday": {
"enabled": true,
"ranges": [
{
"from": "09:00",
"to": "17:00"
}
]
}
}
}
],
"voicemail_prompt": "en-US",
"enable_voicemail_pin": true,
"voicemail_pin": "text",
"enable_voicemail_notify": false,
"voicemail_play_datetime": "DISABLE",
"interface": "WEB_DOMAIN",
"preferred_transport": "UDP",
"blfs": [
{
"key": "text",
"value": "text",
"first_name": "text",
"last_name": "text"
}
]
}No content