Zoho Recruit Real Time Events
List of Events Supported by Zoho Recruit
Knit Event ID | Support | Zoho Recruit Webhook Event |
---|---|---|
ats_applications_new | Yes | Create |
ats_applications_modified | Yes | Edit, Change Status |
ats_applications_deleted | No | |
ats_jobs_new | Yes | Create |
ats_jobs_modified | Yes | Edit, Field update, Change status of job opening |
ats_jobs_deleted | Yes | Delete |
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:
-
Navigate to:
Setup ⚙️ > Automation > Workflow Rules, then click on “Create Rule”. -
Fill in all required details in the popup window (such as module, rule name, description, etc.).
-
Proceed to configure this new workflow rule as follows:
- Set the appropriate criteria and execution conditions.
- Insert a new action of type Webhook.
-
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 ValueapplicationId
→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 ValuejobId
→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
Updated 16 days ago