---
title: Customizing the integration
slug: customizing-the-integration
docTags: 
createdAt: 2022-11-15T19:19:50.000Z
---

:::hint{type="info"}
[Packages](https://www.charthop.com/pricing/)**:&#x20;**<font color="#a9a9a9">Basic</font> <font color="#000000">|</font> <font color="#000000">**Standard*** | **Premium**</font>****

\* Available as an add-on
:::

With custom field mappers, you can configure your integration to better match your job data between ChartHop and Lever.

## Create custom field mappers

You can map additional Lever fields to add or change what data is given to ChartHop.&#x20;

Keep in mind that there are some exceptions, so for more information about managing custom field mappings, please contact your ChartHop implementation specialist.

You can use custom field mappers to override the default field mappings. For example, you can pull a custom field into a ChartHop default field, or vice versa (to push a ChartHop custom field into a default field on Lever). Similarly, you can disable default field mappers. 

:::hint{type="info"}
Group fields like Department, Team, and Location cannot be custom mapped.
:::



![You can use custom field mappers to override the default field mappings.](https://api.archbee.com/api/optimize/CXAjUAezd9VEEVQBIYmdw/6OJLR889wrnciy16s907j_group-8.png "You can use custom field mappers to override the default field mappings.")

To create a custom field mapper, follow these steps:

1. From the left sidebar, select **Apps & Bundles**.
2. From the sub-menu, select **Apps**.
3. Select the **Installed Apps** tab.
4. Scroll the list down to the **Lever Requisitions&#x20;**&#x61;pp.
5. Select the **Lever Requisitions&#x20;**&#x61;pp.
6. From the ChartHop **Lever Requisitions&#x20;**&#x61;pp settings page, scroll down and select the **Add Field Mapper&#x20;**&#x62;utton.
7. Enter your Lever custom field **Code name** under **Remote Field**, appended with the correct endpoint.
   - To ensure that your Lever field parses correctly, your **Remote Fields** must be preceded by the correct endpoint (job., offer., etc.), and structured as follows:
     - The endpoint (such as job) + custom\_fields. + your Lever Immutable Field.
8. In the **ChartHop Field**, enter the field or Carrot expression you wish to map to the previously entered Lever custom field.

As an example, if you wanted to map a ChartHop custom field like *targetSalary* to the Lever custom field *targetBase*, then you’d want to set up your field mapper like in the image below:

:::hint{type="info"}
You can map multiple ChartHop fields to a single Lever field.
:::

![The custom ChartHop Field: targetSalary is mapped to the custom Remote Field: targetBase.](https://api.archbee.com/api/optimize/CXAjUAezd9VEEVQBIYmdw/Lpg3ZxB9CCNp38l2nBMjx_group-9.png "The custom ChartHop Field: targetSalary is mapped to the custom Remote Field: targetBase.")

Ensure you are using the correct name of the field(s) you want to map. Incorrect names will cause the mapping to fail.

## Set new hire announce dates

When candidates are hired and they are created in ChartHop, you have a choice about when you want them to show up publically to your organization

Under the option **New Hire Webhook Announce Date&#x20;**&#x73;elect one of the following:

- **Start date** - The new hire will not be org public until their start date.&#x20;
- **Today** - The new hire will be displayed immediately on the day of the sync
- **Earlier of start date and today (Default)**