Skip to main content

Update Contact

Each user API request in TeleCMI platform includes user login token. After getting the user login token, make a POST request to the below base URL to update existing contact details.

Base URL​

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

https://rest.telecmi.com/v3/contact/update

Required Parameters​

These are the required POST method parameters with description

Parameter NameTypeDescription
*tokenstringYour user token
*contactsarrayList of contact objects to update (max 100)

Update Contact Object Fields​

FieldTypeRequiredDescription
*contact_idstringYesUUID of the contact to update
phone_nostringNoNew phone number
first_namestringNoUpdated first name
last_namestringNoUpdated last name
email_idstringNoUpdated email address
companystringNoUpdated company name
job_titlestringNoUpdated job title
Note
The * marked parameter/field is mandatory.

Sample JSON Request​

Below is the following sample JSON POST method request

{
"token": "xxxx-xxxx-xxxx-xxxx",
"contacts": [
{
"contact_id": "d3b07384-d113-4ec5-a5ae-be81d6e3c239",
"phone_no": "919200000001",
"first_name": "John",
"last_name": "Smith",
"email_id": "john.smith@example.com",
"company": "Acme Corp",
"job_title": "Senior Software Engineer"
}
]
}

Sample Response​

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

{
"code": 200,
"msg": "Contacts updated successfully"
}

Properties​

These are the list of properties and its description

PropertyTypeDescription
codenumberHTTP status code (200 for success)
msgstringResponse message details

HTTP status codes​

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

Status codeStatus TypeDescription
200SuccessContacts updated successfully
400ErrorInvalid request parameters / Validation error
404ErrorAuthenticated user record not found
409ErrorDuplicate contact detected within the organization
500ErrorSomething went wrong!