Zoho CRM Custom icon

Zoho CRM Custom

Consume Zoho CRM API

Overview

The Zoho CRM Custom node for n8n allows you to interact with the Zoho CRM API. Specifically, when using the Contact resource and the Update operation, this node updates an existing contact in your Zoho CRM account with new or modified information. This is useful for keeping your CRM data synchronized with other systems, automating updates based on external triggers, or batch-updating contacts as part of a workflow.

Practical examples:

  • Automatically update a contact's details when they submit a form on your website.
  • Sync changes from another database or application into Zoho CRM contacts.
  • Enrich contact records with additional information from third-party services.

Properties

Name Type Meaning
Contact ID String ID of the contact to update. Required to identify which contact will be updated.
Update Fields Collection Fields to update on the contact. You can specify one or more fields to change.
Assistant String Name of the contact’s assistant.
Assistant’s Phone String Phone number of the contact’s assistant.
Currency Options Symbol of the currency in which revenue is generated (e.g., USD, EUR, etc.).
Custom Fields FixedCollection Set custom field values by specifying field ID and value.
Date of Birth DateTime The contact’s date of birth.
Department String Department where the contact works.
Description String Additional notes or description about the contact.
Email (Primary) String Primary email address of the contact.
Email (Secondary) String Secondary email address of the contact.
Fax String Fax number of the contact.
First Name String First name of the contact.
Full Name String Full name of the contact.
Home Phone String Home phone number of the contact.
Last Name String Last name of the contact.
Mailing Address FixedCollection Mailing address fields: Street, City, State, Country, Zip Code.
Mobile String Mobile phone number of the contact.
Other Address FixedCollection Other address fields: Street, City, State, Zip Code.
Other Phone String Other phone number of the contact.
Phone String Main phone number of the contact.
Salutation String Salutation (e.g., Mr., Ms., Dr.) for the contact.
Skype ID String Skype ID of the contact.
Title String Position of the contact at their company.
Twitter String Twitter handle of the contact.

Note: Only the fields you include in "Update Fields" will be changed; others remain untouched.


Output

The output is a JSON object containing the details of the updated contact as returned by the Zoho CRM API. The structure typically includes all standard and custom fields of the contact after the update.

Example output:

{
  "id": "1234567890",
  "Last_Name": "Doe",
  "First_Name": "John",
  "Email": "[email protected]",
  "Phone": "+123456789",
  // ...other fields as present in Zoho CRM...
}
  • If the update is successful, the output contains the updated contact's details.
  • If there is an error and "Continue On Fail" is enabled, the output will contain an error property with the error message.

Dependencies

  • Zoho CRM Account: You must have a Zoho CRM account.
  • API Credentials: Requires OAuth2 credentials (zohoOAuth2Api) configured in n8n.
  • n8n Configuration: The node must be properly authorized to access your Zoho CRM instance.

Troubleshooting

Common issues:

  • Missing or Invalid Contact ID: If the provided Contact ID does not exist or is incorrect, the update will fail.
  • No Fields Provided: If "Update Fields" is empty, the node will throw an error indicating that no fields were specified for update.
  • Insufficient Permissions: The connected Zoho user must have permission to update contacts.
  • Invalid Field Values: Providing values in an incorrect format (e.g., wrong date format) may cause errors.

Error messages and resolutions:

  • "No fields to update": Ensure you provide at least one field in "Update Fields".
  • "Record not found": Check that the Contact ID is correct and exists in Zoho CRM.
  • "Invalid data": Review the field values for correct formatting and allowed options.

Links and References

Discussion