Skip to main content

​
What can you do with it?

Manage contacts, leads, accounts, deals and other CRM data with Zoho CRM, including retrieving all contacts, getting specific contact details, creating new contacts, updating contact information, and searching contacts for comprehensive customer relationship management.

​
How to use it?

​
Basic Command Structure

/your-zoho-connection [action] [required-parameters] [optional-parameters]

​
Parameters

Required:
  • action - The operation to perform (get-all-contacts, get-contact, create-contact, update-contact, search-contacts)
Optional:
  • contact-id - Zoho contact ID
  • first-name - Contact first name
  • last-name - Contact last name
  • email - Contact email address
  • phone - Contact phone number
  • search-criteria - Search criteria for contact lookup
  • account-id - Associated account ID
  • title - Contact job title
  • address - Contact address information

​
Tools

​
Get All Contacts

Retrieve a list of all contacts from Zoho CRM Parameters:
  • No parameters required
Example: 
/your-zoho-connection
action: get-all-contacts
Response: 
{
  "data": [
    {
      "id": "123456789",
      "First_Name": "John",
      "Last_Name": "Doe",
      "Email": "[email protected]",
      "Phone": "+1 555-123-4567",
      "Account_Name": {
        "id": "987654321",
        "name": "Example Company"
      },
      "Owner": {
        "id": "112233445",
        "name": "Sales Rep"
      },
      "Created_Time": "2023-01-15T10:30:00-08:00",
      "Modified_Time": "2023-02-20T14:45:00-08:00"
    }
  ],
  "info": {
    "per_page": 200,
    "count": 15,
    "page": 1,
    "more_records": false
  }
}

​
Get Contact

Retrieve details of a specific contact using its ID Parameters:
  • contact-id (required) - Zoho contact ID
Example: 
/your-zoho-connection
action: get-contact
contact-id: 123456789
Response: 
{
  "data": [
    {
      "id": "123456789",
      "First_Name": "John",
      "Last_Name": "Doe",
      "Email": "[email protected]",
      "Phone": "+1 555-123-4567",
      "Mailing_Street": "123 Main St",
      "Mailing_City": "San Francisco",
      "Mailing_State": "CA",
      "Mailing_Zip": "94105",
      "Mailing_Country": "USA",
      "Account_Name": {
        "id": "987654321",
        "name": "Example Company"
      },
      "Title": "CEO",
      "Department": "Executive",
      "Owner": {
        "id": "112233445",
        "name": "Sales Rep"
      },
      "Created_Time": "2023-01-15T10:30:00-08:00",
      "Modified_Time": "2023-02-20T14:45:00-08:00"
    }
  ]
}

​
Create Contact

Add a new contact to Zoho CRM with contact details Parameters:
  • first-name (required) - Contact first name
  • last-name (required) - Contact last name
  • email (required) - Contact email address
  • phone (optional) - Contact phone number
  • title (optional) - Contact job title
  • account-id (optional) - Associated account ID
  • address (optional) - Contact address information
Example: 
/your-zoho-connection
action: create-contact
first-name: Jane
last-name: Smith
email: [email protected]
phone: +1 555-987-6543
title: CTO
account-id: 987654321
address: 456 Oak Ave, New York, NY 10001, USA
Response: 
{
  "data": [
    {
      "code": "SUCCESS",
      "details": {
        "id": "456789123",
        "Created_Time": "2023-03-10T09:15:00-08:00",
        "Modified_Time": "2023-03-10T09:15:00-08:00",
        "Created_By": {
          "id": "112233445",
          "name": "Sales Rep"
        },
        "Modified_By": {
          "id": "112233445",
          "name": "Sales Rep"
        }
      },
      "message": "record added",
      "status": "success"
    }
  ]
}

​
Update Contact

Update an existing contact’s information Parameters:
  • contact-id (required) - Zoho contact ID
  • first-name (optional) - Updated first name
  • last-name (optional) - Updated last name
  • email (optional) - Updated email address
  • phone (optional) - Updated phone number
  • title (optional) - Updated job title
  • address (optional) - Updated address information
Example: 
/your-zoho-connection
action: update-contact
contact-id: 456789123
phone: +1 555-111-2222
title: VP of Engineering
address: 789 Pine St, San Francisco, CA 94105
Response: 
{
  "data": [
    {
      "code": "SUCCESS",
      "details": {
        "id": "456789123",
        "Modified_Time": "2023-03-15T11:30:00-08:00",
        "Modified_By": {
          "id": "112233445",
          "name": "Sales Rep"
        }
      },
      "message": "record updated",
      "status": "success"
    }
  ]
}

​
Search Contacts

Search for contacts based on specific criteria Parameters:
  • search-criteria (required) - Search criteria (e.g., “Email:equals:[email protected]”)
  • fields (optional) - Fields to retrieve in search results
Example: 
/your-zoho-connection
action: search-contacts
search-criteria: Email:equals:[email protected]
fields: First_Name,Last_Name,Email,Phone
Response: 
{
  "data": [
    {
      "id": "456789123",
      "First_Name": "Jane",
      "Last_Name": "Smith",
      "Email": "[email protected]",
      "Phone": "+1 555-111-2222",
      "Account_Name": {
        "id": "987654321",
        "name": "Example Company"
      },
      "Title": "VP of Engineering",
      "Owner": {
        "id": "112233445",
        "name": "Sales Rep"
      },
      "Created_Time": "2023-03-10T09:15:00-08:00",
      "Modified_Time": "2023-03-15T11:30:00-08:00"
    }
  ],
  "info": {
    "per_page": 200,
    "count": 1,
    "page": 1,
    "more_records": false
  }
}

​
Notes

Zoho CRM API uses v2 endpoints for contact management. Contact IDs are numeric identifiers returned from create and search operations. Search criteria use colon-separated format like “Field:operator:value”. Supported operators include equals, contains, starts_with, ends_with. Account associations require valid account IDs. Address information can be split into Street, City, State, Zip, and Country fields. All timestamps are in ISO 8601 format with timezone information.