Installing the Zenefits app
This section covers setting up the Zenefits integration app, which allows you to sync your employee roster to ChartHop.
For ChartHop to access your organization's Zenefits payroll data, you need to create an API token in Zenefits that you can use in ChartHop. This information allows ChartHop to connect to Zenefits to receive your employee data.
- From Zenefits, go to the Custom Integrations option from the Company Profile.
- Select Add Token.
- Select the scopes that include employment and personal data.
- Click Save.
- Click the eye icon to unmask the token and copy the API key.
After you have your Zenefits API token, you can install the Zenefits integration app in ChartHop.
You'll be prompted to configure your payroll app when you select Install.
- In the Create your API token step, copy the API token you created to the provided field.
- Select Next step.
- Expand the Advanced settings section.
- Use the following table to guide you through advanced settings decisions.
Setting | Description |
---|---|
Missing location information
| Select one of the two options for what should happen if location information is set for an open role:
|
Advanced sync options | Select the data changes you want to include in your sync. You can include some or all of the following employee data:
|
Overwrite person fields
| ChartHop recommends using this setting to avoid needing to update both ChartHop and your payroll system when a change is made to any field value that is synced from your payroll system. When you choose this option, your payroll system remains the source of truth for the following fields in ChartHop: birthdate, gender, home address, and so on. Any edits you or an employee make to this data in ChartHop are overwritten during synchronization. This can pose an issue when someone uses ChartHop to update employee fields in ChartHop, without requesting an update in the source system. |
Historical data | Choose whether or not you want to sync historical data. You can turn this off if you want to exclude any historical changes before the date of your initial sync. |
Exclude IDs | To exclude specific individuals from the sync, enter their unique payroll system IDs here, separated by commas. |