Skip to main content

Add User

Each API request in TeleCMI platform includes App id and secret. Get your App id and secret in TeleCMI dashboard. After getting the app id and secret, make a POST request to the below base URL to add the user in your app.

Base URL

Send your POST method request with valid parameters, to the following base URL.

https://rest.telecmi.com/v2/user/add

Required Parameters

These are the required POST method parameters with description

Parameter NameTypeDescription
*appidnumberYour app ID
*secretstringYour app secret
*extensionnumberThe three digit extension for user
*namestringThe name of the user
*phone_numberstringThe phone number of the user
*passwordstringThe password of the user
start_timenumberThe user shift time to start receiving the incoming call
end_timenumberThe user shift time to stop receiving the incoming call
sms_alertbooleanThe missed call notification for the user
Note
The * marked parameter is mandatory.

Sample JSON Request

Below is the following sample JSON POST method request

{
"appid":1111112,
"secret":"xxxx-xxxx-xxxx-xxxx",
"extension":101,
"name":"Manish",
"phone_number":"919200000000",
"password":"123456",
"start_time":1,
"end_time":24,
"sms_alert":true
}

Sample Response

If the provided information is valid, your web server will get a sample response from TeleCMI Platform as given below

{
"code": 200,
"status": "success",
"msg": "Saved successfully",
"agent": {
"agent_id": "101_1111112",
"name": "Manish",
"extension": 101
}
}

Properties

These are the list of properties and its description

PropertyTypeDescription
statusstringThe status of the request, success or error
msgstringThe message information of the request
agentJSON arrayThe added user details
agent_idstringThe created user ID
namestringThe name of the user
extensionnumberThe three digit extension of the user

HTTP status codes

TeleCMI API platform represents the following status code to identity the errors.

Status codeStatus TypeDescription
200SuccessWe received the request
401ErrorAuthentication failed
400ErrorParameter missing, User ID Already Exists, User limit reached