# Streamline Employee Onboarding and Offboarding with the HRIS API

Effortlessly synchronize employee data from [over 50 HRIS providers](/apis/hris) into your product and maintain up-to-date employee records as they evolve. Apideck's [HRIS API](/apis/hris/reference) supports both polling and webhook-based approaches for seamless integration.

## Prerequisites

Before you begin, ensure you have:

- An [Apideck account](https://www.apideck.com/signup)
- Completed the steps in the [Get Started](https://developers.apideck.com/get-started) guide to set up your application

>
> For testing purposes, we recommend setting up a sandbox account with an HRIS provider. You can
> find sign-up links for many popular HRIS providers in the Apideck admin when activating a
> connector. Here are some recommended providers with a free trial:
> [Personio](https://www.personio.com/free-trial/), [BambooHR](https://www.bamboohr.com/signup/),
> and [HiBob](https://www.hibob.com/book-a-demo/).

## Implementation Guide

### 1. Enable HRIS Integration for Your Customers

Let each customer connect their own HRIS provider from your app's onboarding screen. If they need custom
fields mapped, use Apideck Vault (consumer) or the Apideck Dashboard to **Configure Field Mappings**.

### 2. Retrieve Employee Data

Import employee data with these endpoints:

- [`/hris/employees`](/apis/hris/reference#tag/Employees/operation/employeesAll): Import active employees and onboard them to your product.
- [`/hris/departments`](/apis/hris/reference#tag/Employees/operation/departmentsAll) and [`/hris/companies`](/apis/hris/reference#tag/Employees/operation/companiesAll): Gather additional employee information for grouping or auto-provisioning in your product.

### 3. Maintain Up-to-Date Employee Records

Choose one of the following methods to keep employee data current:

#### Option A: Utilize Webhooks (Recommended)

After the initial import, subscribe to these webhook events:

- [Employee Created](/apis/hris/reference#tag/Webhook-Events/operation/employeeCreated)
- [Employee Updated](/apis/hris/reference#tag/Webhook-Events/operation/employeeUpdated)
- [Employee Deleted](/apis/hris/reference#tag/Webhook-Events/operation/employeeDeleted)
- [Employee Terminated](/apis/hris/reference#tag/Webhook-Events/operation/employeeTerminated)

These events will help you track new hires, departures, and changes to existing employee records. Follow our [Webhooks guide](/guides/webhooks) to set up your product for receiving these events.

#### Option B: Implement Polling

Alternatively, you can regularly call the [`/hris/employees`](/apis/hris/reference#tag/Employees/operation/employeesAll) endpoint to track changes. Pay attention to these fields:

- **employment_status**
- **employment_start_date**
- **employment_end_date**

These fields will help you monitor employees joining and leaving your organization.

## Get Started Today

Ready to streamline your employee onboarding and offboarding process? Discover how Apideck can unlock hundreds of B2B integrations for your business by [signing up for free](https://www.apideck.com/signup) or [talking to an expert](https://meetings-eu1.hubspot.com/gertjan-de-wilde/talk-to-an-expert-demo).