Payroll and HRIS handover webhook
When you convert a joiner to an employee, OneATS posts their details (name, contact, designation, department, location, joining date and salary) to a URL you choose, signed with your secret.
Why connect it
Why connect Payroll & HRIS webhook to OneATS
No re-typing new hires
Eliminate manual data re-entry between recruiting, onboarding, and payroll systems.
Signed, so you can trust it
Every payload is signed with HMAC-SHA256 using your secret token to prevent spoofing.
Works with any HR system
Send new hires to Keka, greytHR, Zoho People, BambooHR or a custom system through your own receiver endpoint, or an automation tool like Zapier or Make.
Setup
How to set up Payroll & HRIS webhook
The steps below match the screens in your OneATS portal.
Keys, provider links and portal locationWhat you need
- An HTTPS endpoint that accepts JSON POST requests (your internal API or a Zapier/Make/Power Automate webhook trigger)
- A secret string (32+ characters) for cryptographic verification
- A OneATS Business plan or higher
Create the receiving URL
Set up an endpoint on your server or configure a webhook trigger in your automation tool.
Configure in OneATS
Go to Settings → Onboarding Checklists & Payroll → Payroll & HRIS Handover, paste your endpoint URL and secret, then save.
Settings → Onboarding Checklists & Payroll
Verify payload signature
In your receiving code, compute the HMAC-SHA256 signature using the x-oneats-timestamp and raw body to verify authenticity.
Convert a test joiner
Convert an onboarded candidate to verify successful payload delivery and processing.
- OneATS doesn't connect to Keka, greytHR, Zoho People or BambooHR directly. Your receiver endpoint or automation workflow creates the employee record in those systems.
Keys and links
Keys you need for Payroll & HRIS webhook and where they go
Provide an HTTPS endpoint and secret to automatically post converted employee records to your payroll or HR system.
- Endpoint URLYour internal payroll ingestion API or automation tool webhook trigger.Field
Webhook URL - Signing SecretA random secret string (32+ characters) used to sign payloads with HMAC-SHA256.Field
Signing Secret
- OneATS dispatches employee.created events with x-oneats-signature and x-oneats-timestamp headers to guarantee authenticity.
- Failed attempts automatically retry up to 3 times with exponential backoff on server errors.
Where it goes in OneATS
- Settings
- Onboarding Checklists & Payroll
- Payroll & HRIS Handover
Then select Save Payroll Webhook.
Open this screen in OneATSAdmins only. You'll be asked to sign in.
- When a candidate is marked as converted, OneATS dispatches an employee.created event with standard JSON payload.
- Headers include x-oneats-signature (t=...,v1=...), x-oneats-timestamp, and x-oneats-delivery-id.
- Failed dispatches automatically retry up to 3 times with exponential backoff on 5xx errors or network timeouts.
Questions
Payroll & HRIS webhook questions
Is there a CSV option?
Yes. You can export converted employees as CSV directly from the Onboarding portal at any time.
Which HR systems work?
Any system that has an open API or can receive triggers from Zapier, Make, or Power Automate.
Related integrations
All integrations →Start hiring better today
Free plan available. No credit card required. Set up in minutes.