Zoho Books icon

Zoho Books

Consume Zoho Books API

Actions76

Contact → Create

AI-generated

Overview

This node integrates with Zoho Books to create a new contact record. It is useful for automating the addition of contacts into Zoho Books from various sources, such as form submissions, CRM systems, or other applications. For example, when a new lead is captured on a website, this node can automatically create a corresponding contact in Zoho Books, ensuring your accounting and invoicing system stays up-to-date without manual entry.

Properties

Name Meaning
Contact Name The full name of the contact (required).
Company Name The company associated with the contact.
Email The email address of the contact.
Phone The phone number of the contact.
Website The website URL related to the contact.
Currency Code The currency code used for this contact's transactions. Options: USD, EUR, GBP, CAD, AUD, INR.
Opening Balance The initial balance amount for the contact, with two decimal precision.
Billing Address The billing address details including street, city, state, ZIP/postal code, and country.
Shipping Address The shipping address details including street, city, state, ZIP/postal code, and country.
Custom Fields Additional custom fields that can be set for the contact to capture extra information.

Output

The node outputs JSON data representing the newly created contact record as returned by the Zoho Books API. This typically includes the contact's unique ID, name, company, contact details, addresses, currency, balances, and any custom fields set. There is no binary output.

Example output JSON structure (simplified):

{
  "contact_id": "123456789",
  "contact_name": "John Doe",
  "company_name": "Example Corp",
  "email": "john.doe@example.com",
  "phone": "+1234567890",
  "website": "https://example.com",
  "currency_code": "USD",
  "opening_balance": 100.00,
  "billing_address": {
    "street": "123 Main St",
    "city": "Anytown",
    "state": "CA",
    "zip": "90210",
    "country": "USA"
  },
  "shipping_address": {
    "street": "456 Other St",
    "city": "Othertown",
    "state": "CA",
    "zip": "90211",
    "country": "USA"
  },
  "custom_fields": {
    // custom field key-value pairs
  }
}

Dependencies

  • Requires an active Zoho Books account.
  • Requires an API authentication token or OAuth2 credentials configured in n8n to access the Zoho Books API.
  • No additional external dependencies beyond the Zoho Books API.

Troubleshooting

  • Common issues:
    • Missing required fields such as Contact Name will cause the API request to fail.
    • Invalid currency codes or improperly formatted addresses may result in errors.
    • Authentication failures if the API credentials are invalid or expired.
  • Error messages:
    • "Unsupported resource": Indicates the selected resource is not implemented; ensure "Contact" is chosen.
    • API errors from Zoho Books will be passed through; check the error message for details like validation errors or permission issues.
  • Resolution tips:
    • Verify all required fields are provided and correctly formatted.
    • Ensure the API credentials are valid and have sufficient permissions.
    • Use the "Continue On Fail" option in n8n to handle individual item errors gracefully.

Links and References

Discussion