Contacts API
Contact CRUD APIs
Authorization
HeaderKey | Description |
Authorization * | Zoho-oauthtoken<space><ACCESS_TOKEN> |
Accept * | Set to application/json. |
*All APIs are accessible under zohovoice.contacts.ALL scope.
Create Contact
Use this API to create a contact record.
POST https://voice.zoho.com/rest/json/zv/contacts |
Scope: zohovoice.contacts.CREATE
Param Name | DataType | Description |
contact * | string | Contact data as json. first_name and mobile keys are mandatory. JSON Schema: {"first_name":"<string>","last_name":"<string>","email":"<string>","mobile":"<string>","mobile1":"<string>","mobile2":"<string>","mobile3":"<string>","phone":"<string>","phone1":"<string>","phone2":"<string>","phone3":"<string>","company":"<string>","address":"<string>","state":"<string>","country":"<string>","is_favourite":"<string>","is_spam":"<string>","contact_status":{"id":"<id of status>","display_value":"<display value of status>"}}
|
{
"code": "200",
"contacts": {
"country": "",
"created_time": 1728037831825,
"is_spam": "",
"address": "",
"mobile": "+12015550123",
"mobile1": "",
"phone2": "",
"last_name": "",
"phone3": "",
"is_favourite": "",
"contact_id": 315000153768793,
"phone1": "",
"number": [
"+12015550126"
],
"phone": "",
"mobile3": "",
"mobile2": "",
"contact_owner": 415005010526109,
"company": "",
"state": "",
"first_name": "test",
"email": ""
},
"status": "SUCCESS"
}
FAILURE
{
"code": "<App Error Code>",
"message": "<Error Message>",
"status": "ERROR"
}
Get All Contact Status
Use this API to get contact statuses.
GET https://voice.zoho.com/rest/json/zv/contacts/contact_status |
Scope: zohovoice.contacts.READ
Response
SUCCESS
{
"code": "200",
"contact_status": [
{
"display_value": "Active",
"id": "1000000000027"
},
{
"display_value": "In Active",
"id": "1000000000029"
},
{
"display_value": "VIP",
"id": "1000000000031"
}
],
"status": "SUCCESS"
}
{
"code": "<App Error Code>",
"message": "<Error Message>",
"status": "ERROR"
}
Get All Contacts
Use this API to get contacts.
GET https://voice.zoho.com/rest/json/zv/contacts |
Scope: zohovoice.contacts.READ
Parameters
Param Name | DataType | Description |
totalCount | boolean | true/false (In case total count is needed) |
from | integer | 0 |
size | integer | 1-50 |
Response
{
"code": "200",
"meta": {
"total": -1
},
"contacts": [
{
"country": "",
"is_spam": "",
"address": "",
"mobile": "+15135493562",
"mobile1": "",
"phone2": "",
"last_name": "8Foller",
"phone3": "",
"is_favourite": "",
"contact_id": "347000014281004",
"phone1": "",
"phone": "+15135495601",
"mobile3": "",
"contact_owner": {
"display_value": "Vignesh",
"id": "347000000003015"
},
"mobile2": "",
"company": "",
"state": "",
"first_name": "Andrej",
"email": ""
},
{
"country": "",
"is_spam": "",
"address": "",
"mobile": "+18562644130",
"mobile1": "",
"phone2": "",
"last_name": "91Venere",
"phone3": "",
"is_favourite": "",
"contact_id": "347000014281005",
"phone1": "",
"phone": "+18566368749",
"mobile3": "",
"contact_owner": {
"display_value": "Vignesh",
"id": "347000000003015"
},
"mobile2": "",
"company": "",
"state": "",
"first_name": "Art",
"email": ""
}
],
"status": "SUCCESS"
}
{
"code": "<App Error Code>",
"message": "<Error Message>",
"status": "ERROR"
}
Delete a Contact
Use this API to delete a contact record.
DELETE https://voice.zoho.com/rest/json/zv/contacts/<contact_id> |
Scope: zohovoice.contacts.DELETE
Response
SUCCESS
{
"code": "200",
"contacts": "<contact_id>",
"status": "SUCCESS"
}
FAILURE
{
"code": "<App Error Code>",
"message": "<Error Message>",
"status": "ERROR"
}
Get a Contact
Use this API to get a contact record.
GET https://voice.zoho.com/rest/json/zv/contacts/<contact_id> |
Scope: zohovoice.contacts.READ
Response
SUCCESS
{
"code": "200",
"contacts": {
"country": "",
"created_time": 1728037831825,
"is_spam": "",
"address": "",
"mobile": "+12015550123",
"mobile1": "",
"phone2": "",
"last_name": "",
"phone3": "",
"is_favourite": "",
"contact_id": 315000153768793,
"phone1": "",
"number": [
"+12015550126"
],
"phone": "",
"mobile3": "",
"mobile2": "",
"contact_owner": 415005010526109,
"company": "",
"state": "",
"first_name": "test",
"email": ""
},
"status": "SUCCESS"
}
{
"code": "<App Error Code>",
"message": "<Error Message>",
"status": "ERROR"
}
Update a Contact
Use this API to update a contact record.
PUT https://voice.zoho.com/rest/json/zv/contacts/<contact_id> |
Scope: zohovoice.contacts.UPDATE
Parameters
Param Name | DataType | Description |
contact * | string | Contact data as json. first_name and mobile keys are mandatory. JSON Schema: {"first_name":"<string>","last_name":"<string>","email":"<string>","mobile":"<string>","mobile1":"<string>","mobile2":"<string>","mobile3":"<string>","phone":"<string>","phone1":"<string>","phone2":"<string>","phone3":"<string>","company":"<string>","address":"<string>","state":"<string>","country":"<string>","is_favourite":"<string>","is_spam":"<string>","contact_status":{"id":"<id of status>","display_value":"<display value of status>"}} Get available contact statuses from the get contact status API. |
SUCCESS
{
"code": "200",
"contacts": {
"country": "",
"created_time": 1728037831825,
"is_spam": "",
"address": "",
"mobile": "+12015550123",
"mobile1": "",
"phone2": "",
"last_name": "",
"phone3": "",
"is_favourite": "",
"contact_id": 315000153768793,
"phone1": "",
"number": [
"+12015550126"
],
"phone": "",
"mobile3": "",
"mobile2": "",
"contact_owner": 415005010526109,
"company": "",
"state": "",
"first_name": "test",
"email": ""
},
"status": "SUCCESS"
}
{
"code": "<App Error Code>",
"message": "<Error Message>",
"status": "ERROR"
}
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
All-in-one knowledge management and training platform for your employees and customers.
Create. Review. Publish.
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
Zoho Sheet Resources
Zoho Forms Resources
Zoho Sign Resources
Sign, Paperless!
Zoho TeamInbox Resources
Design. Discuss. Deliver.
Related Articles
Zoho Voice SMS REST API
Authorization HeaderKey Description Authorization * Zoho-oauthtoken<space><ACCESS_TOKEN> Accept * Set to application/json. OAuth Doc Send SMS Use this API to send SMS POST https://voice.zoho.com/rest/json/v1/sms/send Scope : ZohoVoice.sms.CREATE ...Power Dialer API
Create Power Dialer Use this API to create Power Dialer campaign. POST https://voice.zoho.com/rest/json/zv/api/powerdialer OAuth Scope: ZohoVoice.powerdialer.CREATE Parameters Param Name DataType Description name string campaign name ...Import & Customize Campaign for contacts via integrated apps
Zoho Voice's Power Dialer helps you to choose contacts from multiple sources for your campaign: Existing contacts in your Zoho Voice account New contacts imported from a CSV file Contacts from integrated apps In this guide, you will understand the ...Import & Customize Campaign for new contacts via CSV file
Zoho Voice's Power Dialer helps you to choose contacts from multiple sources for your campaign: Existing contacts in your Zoho Voice account New contacts imported from a CSV file Contacts from integrated apps In this guide, you will understand the ...Queues API
Queues CRUD APIs Authorization HeaderKey Description Authorization * Zoho-oauthtoken<space><ACCESS_TOKEN> Accept * Set to application/json. *All APIs are accessible under zohovoice.queues.ALL scope. OAuth Doc Create Queue Use this API to create a ...