Zoho Recruit Real Time Events

List of Events Supported by Zoho Recruit

Step 1: Subscribe to Events and Get the Webhook URL (For Knit customers)

To subscribe to real-time events in Zoho Recruit, you can use the Subscribe to Real Time Events API.

Example cURL Command

curl --location 'https://api.getknit.dev/v1.0/events.subscribe' \
--header 'X-Knit-Integration-Id: <YOUR_INTEGRATION_ID>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--data '{
    "events": [
        "ats_applications_new",
        "ats_applications_modified",
        "ats_jobs_new",
        "ats_jobs_modified",
        "ats_jobs_deleted"
    ]
}'

Example JSON Response

{
  "success": true,
  "data": {
    "webhookUrl": "https://workflows.getknit.dev/webhook/wt_3xvamZYMn6Q7bUzZtB"
  }
}

📘

Zoho Recruit Webhook Prerequisites:

• Must be on a paid plan (Professional or Enterprise).
• User must be an admin with "Manage Webhooks" permission.

Step 2: Configure Webhooks in Zoho Recruit Dashboard (For Knit End-Users)

To forward Zoho Recruit events to Knit, follow these steps to configure webhooks in the Zoho Recruit Dashboard:

1. Navigate to:
   Setup ⚙️ > Automation > Workflow Rules, then click on “Create Rule”.

2. Fill in all required details in the popup window (such as module, rule name, description, etc.).

3. Proceed to configure this new workflow rule as follows:

   • Set the appropriate criteria and execution conditions.
   • Insert a new action of type Webhook.

4. In the "URL to Notify" section, enter the webhookUrl you received in Step 1 or the URL provided by your Knit vendor.

Important Notes

• If you're creating a webhook for applications, the webhook URL Parameters must contain the following fields:

  Parameter Name -> Parameter Value

  • applicationId → Applications → Application Id
  • createdAt → Applications → Created Time
  • updatedAt → Applications → Modified Time

• If you're creating a webhook for jobs, the webhook URL Parameters must contain the following fields:

  Parameter Name -> Parameter Value

  • jobId → Job Openings → Job Opening Id
  • createdAt → Job Openings → Created Time
  • updatedAt → Job Openings → Modified Time

Ensure that the parameter names are exactly as listed to maintain compatibility with Knit’s event processing.

Refer the loom video for setting webhooks in Zoho Recruit dashboard - Zoho Recruit Webhook Setup