Setting up the Jobvite integration

﻿
This section covers the process of setting up your Jobvite integration app to begin migrating requisition data between Jobvite and ChartHop.
Setting up the Jobvite integration app requires the following steps:
Install the Jobvite integration app.
Create a Jobvite API Key/ Secret key and set up the flow of new hire data.
Set up the API connection.
Set up the flow of requisition data.
Install the Jobvite Integration App
To connect Jobvite to ChartHop, you can install the Jobvite integration app in ChartHop.
 To install the Jobvite integration app:
From the left sidebar, select Apps & Bundles.
From the sub-menu, select Apps.
Select the Availible Apps tab.
Scroll the list down to the Jobvite app.
Select Install.
Select Install from the app install page.
Create a Jobvite API and Secret key
In order to create an API and Secret key for your Jobvite integration, you need to send some specified information to your Jobvite representative.
Field
Description
Webhook URL
The URL that is automatically generated in the integration app page. 
﻿
You can get to this page by adding temporary values into the API Key and Secret Key fields as part of the setup flow.
Creator Email
The email tied to any actions performed through the integration. Any changes made by the integration will display as being made by this user in Jobvite. 
Create the Jobvite webhook 
To receive your Jobvite API key, you need to generate a web hook address and send it to your Jobvite representative.
To generate the webhook, complete the following steps:
Navigate to the Jobvite integration app. 
In the app’s Settings section, enter the following:
A temporary value in the API Key field.
A temporary value in the Secret Key field.
﻿Your Creator Email. 
Select Save Settings.
After you save the app’s settings, refresh the page. When the page refreshes, copy the newly created Webhook URL under the Web Hook Setup section in the app.
Contact Jobvite representative﻿
ChartHop partners with Jobvite for this integration, and so you'll need to work with your Jobvite representative to obtain the required Jobvite credentials.
After you generate your webhook url, send an email to your Jobvite CSM with your custom Webhook URL and Creator Email using the following template:
﻿
We are beginning our integration with ChartHop and need an API key generated for Charthop. (Please note that Charthop is a Jobvite partner)

The email I want to associate with the API activity is: [Email]
 
In addition, please help set up a candidate hired webhook to the following URL: [Webhook URL]

Please reply to this email with that information and ensure [email protected] is included. ChartHop has previously integrated with the Jobvite APIs and is CC'ed as the technical contacts and can answer any questions.
﻿
Jobvite may require a zero dollar contract to be submitted in order to complete the API authorization request. Your Implementation Specialist can help you fill out and submit these forms.
Set up the API connection
Once you receive your API and Secret keys from Jobvite, enter your Jobvite API and Secret credentials in the API Key and Secret Key fields in the Settings section of the app. Then, select Save Settings.
Set up the flow of requisition data
Once you establish your API connection, you can configure the type of requisition data flow that the integration runs. 
Select your source of truth
When setting up your integration, you can choose the primary source of truth when referencing new requisition data. Selecting ChartHop results in an outbound job data flow where ChartHop is the source of truth, whereas, selecting Remote System (Jobvite) results in an inbound job data flow where the ATS is the source of truth.
To select your Jobvite integration’s source of truth:
From the left sidebar, select Apps & Bundles.
From the sub-menu, select Apps.
Select the Installed Apps tab.
Scroll the list down to the Jobvite app.
Select the Jobvite app.
From the ChartHop Jobvite app settings page, scroll down to the Source of Truth section.
Select one of the two options:
ChartHop - ChartHop is the source of truth and the integration is configured to run an outbound job data flow.
Remote System (Jobvite) - Jobvite is the source of truth and the integration is configured to run an inbound job data flow.
Configure the Jobvite Requisitions integration
You can configure the Jobvite integration app to handle two types of data migrations (job data flows) between ChartHop and Jobvite. Depending on the type of job data flow you choose, you may enable specific configurations that may either be required or optional but recommended.
These are the required and recommended configurations for each job data flow:
Job data flow type
Configurations
Outbound, ChartHop to Jobvite
Required 
Sync On Change
Recommended   
Run Daily
Inbound, Jobvite to ChartHop
Required
Reverse Sync
Recommended
Run Daily
Remote Location As Default
﻿To establish the configuration settings for your Jobvite Requisitions integration:
From the left sidebar, select Apps & Bundles.
From the sub-menu, select Apps.
Select the Installed Apps tab.
Scroll the list down to the Jobvite app.
Select the Jobvite app.
From the ChartHop Jobvite app settings page, scroll down to the Other Options section.
Select from the following configuration options described in the table below.
After you select your integration’s source of truth, you can select additional options to further customize and configure it:
Field
Description
Run Daily
With this option enabled, the ATS app runs automatically every day. When enabled, regardless of data direction, job-related candidate metrics are pulled on a daily basis every morning. For customers on the inbound job data flow direction, this also causes the inbound job data flow to run on a daily basis every morning.
Sync On Change
Enables the outbound job data data flow direction. When enabled, changes to open jobs are automatically pushed to Jobvite as soon as they are made in ChartHop. This option cannot be selected when Reverse Sync is enabled.
Reverse Sync
When enabled, Jobvite becomes the system of record, and ChartHop is updated with new open roles from Jobvite when the inbound job data flow runs. This option cannot be selected when Sync On Change is enabled.
Remote Location As Default
When enabled, newly synced records that are not assigned a location are assigned the value Remote Location.
Publish Requisition On Creation
When enabled, open jobs that are pushed to Jobvite will automatically be published on career sites (both internal and external).
Set up the flow of new hire data
You can use the new hire webhook job data flow to automatically bring new hires from Jobvite to ChartHop when the candidate is marked as “Filled” or “Offer Accepted” in Jobvite, along with their relevant personal information, such as address, phone number, and email.
The new hire webhook will be added to your integration at the same time as when you contact your Jobvite CSM  for the  API and Secret keys, as part of the same email request. Likewise, you will need to contact your Jobvite CSM if you wish to have your Webhook access removed in the future.
In order to process the new hire in Charthop, the candidate must have an email address in Jobvite.
New hire webhooks will not be processed if the person being hired already exists in ChartHop, even if they aren’t actively in a role. As a result, the integration cannot support:
Internal transfers
Re-hires
Only the first new hire webhook for a ChartHop job is supported. For example, if you update an offer packet and re-hire the candidate in Jobvite, the updated information will not be processed in ChartHop unless the new hire in ChartHop is removed first.
A new hire webhook will not be processed if the job does not exist in ChartHop.

Field	Description
Webhook URL	The URL that is automatically generated in the integration app page. You can get to this page by adding temporary values into the API Key and Secret Key fields as part of the setup flow.
Creator Email	The email tied to any actions performed through the integration. Any changes made by the integration will display as being made by this user in Jobvite.

Job data flow type	Configurations
Outbound, ChartHop to Jobvite	Required Sync On Change Recommended Run Daily
Inbound, Jobvite to ChartHop	Required Reverse Sync Recommended Run Daily Remote Location As Default

Field	Description
Run Daily	With this option enabled, the ATS app runs automatically every day. When enabled, regardless of data direction, job-related candidate metrics are pulled on a daily basis every morning. For customers on the inbound job data flow direction, this also causes the inbound job data flow to run on a daily basis every morning.
Sync On Change	Enables the outbound job data data flow direction. When enabled, changes to open jobs are automatically pushed to Jobvite as soon as they are made in ChartHop. This option cannot be selected when Reverse Sync is enabled.
Reverse Sync	When enabled, Jobvite becomes the system of record, and ChartHop is updated with new open roles from Jobvite when the inbound job data flow runs. This option cannot be selected when Sync On Change is enabled.
Remote Location As Default	When enabled, newly synced records that are not assigned a location are assigned the value Remote Location.
Publish Requisition On Creation	When enabled, open jobs that are pushed to Jobvite will automatically be published on career sites (both internal and external).

Updated 24 Jan 2024

Did this page help you?

Job and new hire data fields

Customizing the Jobvite app

Setting up the Jobvite integration

Install the Jobvite Integration App

Create a Jobvite API and Secret key

Create the Jobvite webhook

Contact Jobvite representative﻿

Set up the API connection

Set up the flow of requisition data

Select your source of truth

Configure the Jobvite Requisitions integration

Set up the flow of new hire data

Contact Jobvite representative