Zoho CRM Webhook Setup

What You’re Setting Up

Workflow rules in Zoho CRM that trigger webhooks when records are created, updated, or deleted. This is how Zoho notifies our middleware about changes in real-time, rather than requiring us to poll the API.

Zoho’s webhook system is different from most platforms. Instead of a single subscription endpoint, you configure webhooks as actions within Zoho’s workflow automation rules.

This takes about 20 minutes per webhook.

Prerequisites

• Admin access to your Zoho CRM account
• API credentials already configured (set those up first)
• The webhook URL we provide for your integration

Step-by-Step Setup

1. Navigate to Workflow Rules

1. In Zoho CRM, go to Setup (gear icon)
2. Under the automation section, find Workflow Rules
3. Click to create a new rule

2. Configure the Trigger

1. Select the module you want to monitor (Contacts, Deals, Accounts, etc.)
2. Choose when the rule should execute:
   • On a record action — this is what you want for most integrations
   • Select the specific action: Create, Edit, Create or Edit, or Delete
3. Optionally add criteria to filter which records trigger the webhook. For example, only contacts with a specific lead source, or only deals above a certain value.

3. Add a Webhook Action

1. In the actions section of the workflow rule, look for the option to add an instant action
2. Choose Webhook as the action type
3. Configure the webhook:
   • URL: Paste the webhook URL we provide
   • Method: POST
   • URL Format: JSON (recommended) or form data
   • Custom Parameters: Add any fields you want included in the payload

4. Configure the Payload

Zoho lets you customize what data is sent in the webhook. For most integrations, we need:

• The record ID
• Key fields from the record (name, email, phone, etc.)
• The action type (create, update, delete) if you’re using one webhook URL for multiple events

You can use Zoho’s merge fields to pull values from the record. For example, ${Contacts.Contact ID} sends the contact’s ID.

We’ll provide the exact payload format we need. If you’re unsure, start by including the record ID and we’ll request additional fields as needed.

5. Save and Activate

1. Name the workflow rule clearly, like “Send New Contacts to AcuCoders”
2. Save the rule
3. Make sure it’s active — new rules are sometimes created in a disabled state

6. Repeat for Each Event

You’ll need a separate workflow rule for each module and event combination you want to capture. For a typical integration, this means:

• Contacts — create and edit
• Deals — create and edit
• Accounts — create and edit

That’s six workflow rules, each with a webhook action.

Common Issues

Webhook Not Firing

If the webhook isn’t sending data, check that: the workflow rule is active, the record meets any criteria you set, and the webhook URL is publicly accessible. Zoho’s workflow rule execution log (under Setup) shows whether rules are triggering.

Payload Missing Fields

If the webhook fires but is missing data, edit the webhook action and add the fields you need using Zoho’s merge field syntax. Field names are module-specific.

Rate Limits on Webhooks

Zoho has limits on how many webhooks can fire per day (varies by plan). If you’re hitting the limit, we may need to consolidate triggers or switch to API polling for high-volume modules.

Deleted Record Webhooks

Zoho’s workflow rules for record deletion have limitations. The webhook may fire, but available data in the payload is limited since the record is being deleted. We typically capture the record ID and handle the rest on our side.

Next Steps

• Set up your API credentials if you haven’t: Zoho CRM API Setup
• Learn more about our CRM Integration Services