Zoho Recruit Real Time Events

List of Events Supported by Zoho Recruit

Knit Event IDSupportZoho Recruit Webhook Event
ats_applications_newYesCreate
ats_applications_modifiedYesEdit, Change Status
ats_applications_deletedNo
ats_jobs_newYesCreate
ats_jobs_modifiedYesEdit, Field update, Change status of job opening
ats_jobs_deletedYesDelete

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

    • applicationIdApplicationsApplication Id
    • createdAtApplicationsCreated Time
    • updatedAtApplicationsModified Time
  • If you're creating a webhook for jobs, the webhook URL Parameters must contain the following fields:

    Parameter Name -> Parameter Value

    • jobIdJob OpeningsJob Opening Id
    • createdAtJob OpeningsCreated Time
    • updatedAtJob OpeningsModified 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