> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://faq.rightperson.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Simployer integration

This guide explains how to connect a customer's Simployer account to RightPerson.
Once the integration is set up, creating a new employee in Simployer will automatically start a background check in RightPerson. The check status and a link to the final report will then be added to the employee's profile in Simployer.
The setup has two parts:
* Part A, RightPerson: completed by a RightPerson admin
* Part B, Simployer: completed by the customer in their Simployer account
## Part A: RightPerson side
Contact RightPerson Support to enable the integration.
Once the integration is enabled, Support will provide you with:
1. Account ID
2. Simployer Webhook Secret
You will need both values when configuring the integration in Simployer.
## Part B: Simployer side
### Step 1: Open Integrations in Simployer
1. Log in to Simployer.
2. Go to Integrations in Simployer: [__Integrations__](https://one.simployer.com/hrm/integrations)
3. Select **Add a new webhook.**
![](https://storage.crisp.chat/users/helpdesk/website/-/5/e/8/7/5e8787bd8ceb4800/image_zodd8h.png)

### Step 2: Configure the webhook
You will see an Add webhook form. Enter the following information:
| Field | What to enter |
| ---- |
| Name | Any name you prefer, for example `RightPerson` |
| Webhook URL | https://core.rightperson.com/simployer/webhook |
| API Key | Paste the Simployer Webhook Secret provided by RightPerson Support |
| Header name | `X-RightPerson-Account-Id` |
| Header value | Paste the Account ID provided by RightPerson Support |

![](https://storage.crisp.chat/users/helpdesk/website/-/5/e/8/7/5e8787bd8ceb4800/image_s9dkj7.png)

Click Save to **save** the webhook.
### Step 3: Set up custom fields for RightPerson
To display the background check status and the final report link in Simployer, create two custom fields.
1. In Simployer, go to **Settings** → **Custom fields**
2. Click + **New field.**
3. Create a field for the background check status, for example **`RightPerson Status`.**
4. Create another field for the report link, for example **`RightPerson Report URL`.**
![](https://storage.crisp.chat/users/helpdesk/website/-/5/e/8/7/5e8787bd8ceb4800/image_qvbe6v.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/5/e/8/7/5e8787bd8ceb4800/image_abmg80.png)

These fields will be updated automatically by RightPerson and displayed on the employee's profile in Simployer.

![](https://storage.crisp.chat/users/helpdesk/website/-/5/e/8/7/5e8787bd8ceb4800/image_554y6p.png)

## Integration complete
The Simployer integration is now set up and ready to use.

When a new employee is created in Simployer, a background check will be automatically started in RightPerson. The RightPerson Status and RightPerson Report URL fields will be updated with the latest check information.
## 📩 Need help?
Do you have questions about the setup, or are the results not appearing in Simployer as expected?
📩 Send us an email at [support@rightperson.com](mailto:support@rightperson.com) and we will be happy to help.