POST - Create a contact record

Purpose

Use this API to create a contact record.

Authorization

HeaderKey	Description
Authorization*	Zoho-oauthtoken<space><ACCESS_TOKEN>
Accept*	Set to application/json.

Request URL

Method: POST

https://voice.zoho.com/rest/json/zv/contacts

Scope: zohovoice.contacts.CREATE

Parameters:

Param Name

Data Type

Description

contact*

String

Represents the contact data in JSON format. The 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 status using the get contact status API.

Sample Request

Copiedcurl "https://voice.zoho.com/rest/json/zv/contacts" \
-X POST \
-H "Authorization:Zoho-oauthtoken *****"

Sample Response - Success

Copied{
  "code": "200",
  "contacts": {
    "country": "",
    "created_time": 1728037831825,
    "is_spam": "",
    "address": "",
    "mobile": "+12222222222",
    "mobile1": "",
    "phone2": "",
    "last_name": "",
    "phone3": "",
    "is_favourite": "",
    "contact_id": 315000153768793,
    "phone1": "",
    "number": [
      "+12000000000"
    ],
    "phone": "",
    "mobile3": "",
    "mobile2": "",
    "contact_owner": 415005010526109,
    "company": "",
    "state": "",
    "first_name": "test",
    "email": ""
  },
  "status": "SUCCESS"
}

Sample Response - Error

Copied{
   "code": "<App Error Code>",
   "message": "<Error Message>",
   "status": "ERROR"
}