How to Set Up Webhooks in Zoho Recruit
After selecting the settings in Brainner, if you enabled “Auto-Import Candidates” and/or “Update Stages” in Brainner, you’ll need to create one or both of the following webhooks in Zoho Recruit::
- https://admin.brainner.ai/api/ats/XXX/webhook?action=new_application
- https://admin.brainner.ai/api/ats/XXX/webhook?action=update_stage
⚠️ Note: These URLs are just examples — please check your specific webhook URLs in the pop-up that appears after clicking Apply Changes:
1. Webhook ending in action=new_application
If you enabled ‘Auto-import candidates from Zoho Recruit’, follow these steps to set up the webhook that imports candidates into Brainner as soon as they apply:
1. Go to the Setup section
2. Under Automation, click 'Actions'
3. In the Webhooks tab, click 'Configure Webhook'
4. Fill in the fields as follows and click 'Save':
o Name: Brainner Candidates
o URL To Notify: Copy and paste the URL provided by Brainner to receive candidates as soon as they apply.
o Method: Post
o Module: Applications
o URL Parameters:
- Parameter Name: id
- Parameter Value: Applications – Application Id
5. Go to Workflow Rules (still under Automation) and click 'Create Rule'
6. Set the following:
• Module ‘Applications’
• Rule name: Brainner Candidates
7. Set the conditions and actions:
• WHEN:
o On a record action
o On candidate applying for a job
• CONDITION 1
o Applications matching certain conditions
o None
• INSTANT ACTIONS
o Webhooks
8. Select the name of the webhook created before in step 6 ‘Brainner Candidates’, click 'Associate' and then 'Save'.
✅ You're all set — Auto-import Candidates from Zoho Recruit is now active!
2. Webhook ending in action=update_stage
If you enabled ‘Keep Candidates Stages in Sync’, use the steps below to set up the webhook that updates candidate stages in Brainner whenever they change in Zoho:
1. Go to the Setup section
2. Under Automation, click 'Actions'
3. In the Webhooks tab, click 'Configure Webhook'
4. Fill in the fields as follows and click 'Save':
o Name: Brainner Update Stages
o URL To Notify: Copy and paste the URL provided by Brainner to update candidates stages..
o Method: Post
o Module: Applications
o URL Parameters:
- Parameter Name: id
- Parameter Value: Applications – Application Id
5. Go to Workflow Rules (still under Automation) and click 'Create Rule'
6. Set the following:
• Module ‘Applications’
• Rule name: Brainner Update Stages
7. Set the conditions and actions:
• WHEN:
o On a record action
o Change Status
o Application from status: 1) Any status > 2) Any Status
• CONDITION 1
o All applications
• INSTANT ACTIONS
o Webhooks
8. Select the webhook you created (Brainner Update Stages), click 'Associate', then click 'Save'.
✅ Done — Candidate stage syncing is now active!
💬 Need help?
For any questions, feel free to reach out to hello@brainner.ai — we’re here to help!