NewCandidate self-scheduling with Google and Microsoft calendars→
Skip to content
LiveHR & payroll

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 location

What 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
  1. Create the receiving URL

    Set up an endpoint on your server or configure a webhook trigger in your automation tool.

  2. Configure in OneATS

    Go to Settings → Onboarding Checklists & Payroll → Payroll & HRIS Handover, paste your endpoint URL and secret, then save.

    Settings → Onboarding Checklists & Payroll

  3. Verify payload signature

    In your receiving code, compute the HMAC-SHA256 signature using the x-oneats-timestamp and raw body to verify authenticity.

  4. Convert a test joiner

    Convert an onboarded candidate to verify successful payload delivery and processing.

  5. 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.FieldWebhook URL
  • Signing SecretA random secret string (32+ characters) used to sign payloads with HMAC-SHA256.FieldSigning 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

  1. Settings
  2. Onboarding Checklists & Payroll
  3. Payroll & HRIS Handover

Then select Save Payroll Webhook.

Open this screen in OneATS

Admins only. You'll be asked to sign in.

After setup

How it works day to day

Read the step-by-step guide →
  • 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.

Start hiring better today

Free plan available. No credit card required. Set up in minutes.