JSON API » speeddials » speeddials/create

Creates a new speed dial.

Input parameters

Requires authentication and the user role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
stypeStringSource type. "phone", or empty string for shared.Yes
snumberStringSource number. Telephone line, or empty string for shared.Yes
sdialStringNumber to dial.Yes
dnumberStringDestination number.Yes
buttonStringButton type. Empty string for none.NoEmpty string.
customerIntegerID of customer to create in.NoCustomer of authentication user.
descriptionStringDescription.NoEmpty string.
dnameStringDestination name..NoEmpty string.
validationInteger1 to validate input then return, 0 for full action.No0

Responses

CodeDescription
200Success.
201Input passed validation. Only returned if validation=1.
400Invalid input parameters specified. Check the key and message fields for more details.
401The authentication details provided are invalid.
402Your role does not allow this.

Data returned

The ID of the created speed dial.

Example: Telephone line speed dial

http://enswitch.example.com/api/json/speeddials/create/?auth_username=user;auth_password=password;stype=phone;snumber=1234567;sdial=1;dnumber=2125551234

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":{ "id":123 } }

Example: Shared speed dial

http://enswitch.example.com/api/json/speeddials/create/?auth_username=user;auth_password=password;stype=;snumber=;sdial=1;dnumber=2125551234

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":{ "id":123 } }

Change history

VersionChanges
3.13Function added.