Zoho Books icon

Zoho Books

Consume Zoho Books API

Contact → Update

AI-generated

Overview

This node updates an existing contact record in Zoho Books. It allows users to modify various details of a contact such as name, company, email, phone, addresses, currency, and custom fields. This is useful for keeping contact information current in your accounting system, ensuring accurate communication and billing.

Practical examples:

  • Updating a customer's phone number or email address after they provide new contact info.
  • Changing the billing or shipping address for a client who has moved.
  • Adjusting the opening balance or currency code for a contact based on new financial arrangements.

Properties

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

Output

The node outputs JSON data representing the updated contact record returned from Zoho Books API. Each output item corresponds to one input item processed and contains the updated contact details.

If multiple contacts are updated in batch, the output will be an array of JSON objects, each paired with the respective input item index.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Zoho Books API authentication credential configured in n8n.
  • Depends on the Zoho Books API being accessible and the user having permissions to update contacts.
  • No additional external services beyond Zoho Books API are required.

Troubleshooting

  • Common issues:

    • Invalid or missing Contact ID will cause the update to fail.
    • Providing invalid field values (e.g., wrong currency code or malformed email) may result in API errors.
    • Network or authentication failures can prevent successful API calls.
  • Error messages:

    • "Unsupported resource": Occurs if the resource parameter is incorrect or not implemented.
    • API error messages from Zoho Books typically indicate validation problems or permission issues.
  • Resolutions:

    • Ensure the Contact ID is correct and exists in Zoho Books.
    • Validate all input fields conform to expected formats and allowed values.
    • Verify API credentials and network connectivity.
    • Use "Continue On Fail" option to handle partial failures gracefully.

Links and References

Discussion