Add Contacts

  • URI to add Contacts: /api/v1/accounts/self/contacts?source={yourApp}

    Note: Specifying the source parameter will let you know from where you have added the contact.

  • Contacts must be constructed in json format and sent via payload

Sample Request

Copiedhttps://contacts.zoho.com/api/v1/accounts/self/contacts?source=ZMail

Payload

Copied{
 "contacts": [
  {
   "middle_name":"middle",
   "designation":"designation",
   "emails":[
       {"is_primary":true,"email_id":"user@yahoo.com"},
        {"email_id":"user@mail.com"}
   ],
   "birth_year":"2015",
   "phones":[
       {"number":"123123123","type":"mobile"},
        {"number":"123123123","type":"mobile"}
   ],
   "nick_name":"user",
   "first_name":"J G",
   "birth_month":"06",
   "address":[
       {
            "street_addr":"work street",
            "postal_code":"work code",
            "street_addr1":"work street1",
            "state":"work state",
            "type":"work",
            "country":"work country",
            "city":"work city"
       }],
    "job_title":"job",
   "company":"company",
   "birth_day":"03",
   "last_name":"last",
   "gender":"M",
   "notes":"notes" 
  }
]
}

Sample Response

Copied{
  "status_code": 201,
  "resource_name": "contacts",
  "message": "Contact added successfully",
  "contacts": {
    "email_id": "user@yahoo.com",
    "contact_id": "4685191000000030004"
  }
}