Skip to main content

Zoho Books Trigger

Overview​

Zoho Books triggers allow you to start workflows automatically when specific events occur in your Zoho Books organization. These triggers use a polling mechanism to detect new records created in your account.

Authenticating with Zoho Books​

Before using triggers, connect your Zoho Books account via OAuth 2.0 in Boltic. See the Integration documentation for setup steps.

Setting Up a Trigger​

Step 1: Create a New Workflow​

  • Log in to your Boltic account and navigate to the "Workflows" page from Left Navigation.
  • Click on the "Create New Workflow" button and select "Zoho Books" as the trigger.

Step 2: Configure the Trigger​

  1. Select your Zoho Books Account connection.
  2. Select Webhook as the resource.
  3. Choose the Event you want to listen to.
  4. Select your Organization ID from the dropdown.
  5. Test the trigger to verify it receives data correctly.

Polling Interval: Triggers check for new records every 15 seconds.

Available Triggers​

New Customer​

Triggered when a new customer (contact) is created in your Zoho Books organization.

Configuration:

  • Organization ID (Required): Select your Zoho Books organization.

Trigger Details:

  • Event: webhook.customer
  • Polling Criteria: Timestamp-based on created_time field (ISO format).
  • API Endpoint: Fetches contacts sorted by creation time in descending order.
  • Data Returned: Complete customer information including contact details, addresses, and account settings.

Use Cases:

  • Customer onboarding workflows
  • CRM synchronization
  • Welcome email automation

New Estimate​

Triggered when a new estimate is created in your Zoho Books organization.

Configuration:

  • Organization ID (Required): Select your Zoho Books organization.

Trigger Details:

  • Event: webhook.estimate
  • Polling Criteria: Timestamp-based on created_time field (ISO format).
  • API Endpoint: Fetches estimates sorted by creation time in descending order.
  • Data Returned: Estimate details, line items, customer information, and pricing.

Use Cases:

  • Sales pipeline tracking
  • Approval workflows
  • Follow-up automation

New Expense​

Triggered when a new expense record is added to your Zoho Books organization.

Configuration:

  • Organization ID (Required): Select your Zoho Books organization.

Trigger Details:

  • Event: webhook.expense
  • Polling Criteria: Timestamp-based on created_time field (ISO format).
  • API Endpoint: Fetches expenses sorted by creation time in descending order.
  • Data Returned: Expense details, amount, category, receipt information, and associated project.

Use Cases:

  • Budget monitoring
  • Expense approval processes
  • Financial reporting

New Item​

Triggered when a new product or service item is added to your Zoho Books inventory.

Configuration:

  • Organization ID (Required): Select your Zoho Books organization.

Trigger Details:

  • Event: webhook.item
  • Polling Criteria: Timestamp-based on created_time field (ISO format).
  • API Endpoint: Fetches items sorted by creation time in descending order.
  • Data Returned: Item details, pricing, tax information, and inventory settings.

Use Cases:

  • Inventory management
  • Catalog synchronization
  • Pricing updates

New Invoice​

Triggered when a new sales invoice is created in your Zoho Books organization.

Configuration:

  • Organization ID (Required): Select your Zoho Books organization.

Trigger Details:

  • Event: webhook.invoice
  • Polling Criteria: Timestamp-based on created_time field (ISO format).
  • API Endpoint: Fetches invoices sorted by creation time in descending order.
  • Data Returned: Invoice details, line items, customer information, payment terms, and amounts.

Use Cases:

  • Payment processing automation
  • Customer notifications
  • Accounting system synchronization

Troubleshooting​

Common Issues​

  • No data received: Ensure your Zoho Books organization has recent records matching the trigger event.
  • Authentication errors: Reconnect your Zoho Books account if the access token has expired.
  • Missing Organization ID: Make sure you have selected a valid organization from the dropdown.
  • Rate limits: Zoho Books API has daily call limits (typically 1,000–5,000 per day depending on plan). Monitor usage to avoid hitting limits.

Support​

  • Contact Boltic support for assistance with configuring Zoho Books triggers.
  • Check Zoho Books API documentation at https://www.zoho.com/books/api/v3/ for detailed technical information.