# 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

When a customer signs into your app and navigates to the employee onboarding screen:

- If applicable, use Apideck Vault (consumer) or Apideck Dashboard to **Configure Field Mappings**, allowing you to map custom fields relevant to the end-user.

### 2. Retrieve Employee Data

Fetch the necessary data using 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).