Skip to content

Starters and leavers from your HR system

When someone is hired or leaves, your HR system already knows. Connect it once and each hire or termination arrives in TenantWard as a request to approve, with the name, job, manager and dates filled in. Nothing is created or removed until someone reviews the plan.

Updated October 19, 2026

Connect it

  1. 1

    Open Company › Help desk › HR system

    BambooHR connects with an API key and is checked every hour. For anything else, choose "Another HR system by webhook": TenantWard shows a web address and a secret, and a Zapier step in Gusto or Rippling sends each hire or leaver to it. Copy both; the secret is shown once.

  2. 2

    Send hires and terminations to the address

    If your HR system can call a webhook, point it at the address. If it can't, most HR and payroll systems can start a Zapier or Make automation when someone is hired or leaves: add a step that sends a POST request (Webhooks by Zapier, or Make's HTTP module) to the address with the JSON below.

  3. 3

    Add the secret

    Send it as the header Authorization: Bearer <secret>, or sign the body with it and send X-TenantWard-Signature: sha256=<HMAC of the body>.

  4. 4

    Send a test hire

    Use a made-up person with a start date. It appears in Inbox › Requests as "New starter". Decline it once you've seen it.

What to send

One JSON object per event. "event" is "hire" or "termination". For leavers, include their work email and end_date (the last day); manager_email becomes who gets their mail.

{"event":"hire","employee":{"id":"123","first_name":"Ana","last_name":"Diaz","work_email":"ana@yourcompany.com","job_title":"Hygienist","department":"Clinical","manager_email":"dana@yourcompany.com","start_date":"2026-11-02"}}

{"event":"termination","employee":{"id":"98","first_name":"Sam","last_name":"Lee","work_email":"sam@yourcompany.com","manager_email":"dana@yourcompany.com","end_date":"2026-11-13"}}

What happens next

  • A hire opens "Add a person" with the name, job and manager filled in, and the company's starter template (license, groups and country) already chosen.
  • A termination opens the offboarding with their last day and who gets their mail filled in. It can be set to run at 6pm on their last day, up to 8 days ahead, and goes for sign-off first if the company's change policy asks for it.
  • The same person and event sent twice makes one request, not two.
  • HR triggers are on the Protect plan.

Questions

Does TenantWard create accounts on its own from HR data?
No. Every hire and termination becomes a request. Someone reviews the plan and confirms it, or the company's change policy sends it for sign-off first.
What if the leaver's email doesn't match an account?
The request says no matching account was found in the last checkup, so the address can be checked before anything runs.

See where your company stands

Check a domain for free. A free account also connects Microsoft 365 or Google Workspace read-only and shows every issue it finds; a plan shows who's affected and fixes it.