Overview
The "Contacts: Create" operation in the Zoho Books n8n node allows users to create a new contact (customer or vendor) in their Zoho Books account. This is useful for automating the process of adding new business contacts, such as when integrating with CRM systems, web forms, or other data sources that collect customer information.
Practical examples:
- Automatically add new customers from an e-commerce platform to Zoho Books.
- Sync leads from a marketing tool into Zoho Books as contacts.
- Batch import contacts from a spreadsheet or another database.
Properties
| Name | Type | Meaning |
|---|---|---|
| Contact Name | String | The full name of the contact to be created. Required for identifying the contact in Zoho Books. |
| Additional Fields | Collection | Optional extra fields to further describe the contact, such as company name, website, and language code. |
| └ Company Name | String | The name of the company associated with the contact. |
| └ Website | String | The website URL of the contact or their company. |
| └ Language Code | Options | Preferred language for communication with the contact. Choices include English, Dutch, Spanish, etc. |
Output
The output will be a JSON object representing the newly created contact in Zoho Books. Typical fields may include:
{
"contact_id": "1234567890",
"contact_name": "John Doe",
"company_name": "Acme Corp",
"website": "https://acme.com",
"language_code": "en",
// ...other contact details returned by Zoho Books API
}
If the node supports binary data output, it would only be relevant if exporting files or documents related to the contact, which is not typical for this operation.
Dependencies
- Zoho Books Account: You must have a valid Zoho Books account.
- API Credentials: Requires OAuth2 credentials configured in n8n under
zohoBooksOAuth2Api. - n8n Configuration: Ensure the Zoho Books node is properly installed and authorized in your n8n instance.
Troubleshooting
- Authentication Errors: If you see errors related to authentication, ensure your OAuth2 credentials are correct and have not expired.
- Missing Required Fields: If "Contact Name" is missing, the API will likely return an error indicating a required field is absent.
- Invalid Field Values: Providing an unsupported value for "Language Code" or malformed URLs for "Website" can cause validation errors.
- API Rate Limits: Zoho Books may enforce rate limits; excessive requests could result in temporary blocks.