Actions62
- Account Actions
- Contact Actions
- Deal Actions
- Invoice Actions
- Lead Actions
- Product Actions
- Purchase Order Actions
- Quote Actions
- Sales Order Actions
- Tags Actions
- Vendor Actions
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. |
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.