Jobvite ATS Integration

Table of Contents

Overview

What Does the Integration Do?

Setup Instructions

Field Mapping

Candidate Volume

Integration Overview

Connecting your Jobvite ATS with Findem allows you to access candidate information, boost collaboration and view all applicant data in both Findem and Jobvite without having to switch between platforms.

Findem’s integration with Jobvite ATS is a bi-directional sync between both platforms, meaning recruiters can accelerate their workflows. With this integration, you can:

• Save time and worry knowing that up to-date candidate information is displayed in both Findem and Jobvite
• Automatically create or update a candidate profile within Jobvite when a candidate responds to an email message

Note:

To help expedite your implementation, Findem requires that a login to your ATS environment be created for our usage. This login will be used to test the flow of information between the ATS and Findem, and by providing it directly to Findem, our engineers and technical staff can validate functions without needing your team to be present. Once the technical implementation is over, you can remove the Findem access from your account.

When you are introduced to your Findem project team, Findem will relay the name and email address of the project team member who will need said login.

In the event your ATS integration will include a sandbox and a production environment, we would request the login be created for both environments.

What Does the Integration Do?

Candidate Export 

Findem integrates with your ATS, allowing you to export candidate data directly to your ATS profiles. Candidates profiles can be exported independently or combined with an application directly to a job requisition. 

Application Review and Disposition

Findem allows recruiters to discover, score and prioritize applicants for any open role. Efficiently review candidate profiles and disposition applications with just a few clicks. 

Note:

While we can set up an email template to be used in the event of a rejection, Findem cannot pull any email templates from Jobvite. To change your rejection email template, contact your Findem Customer Success Manager.

Candidate Rediscovery

Your ATS Data is mirrored in Findem and enriches a candidate’s profile with their ATS history. Candidate statuses, stages, rejection reasons and more are recorded so you have a full picture of your company’s engagement. Search and filter to find past applicants that are qualified for open roles. 

Candidate Refresh

Findem keeps candidate profiles in your ATS up to date while also de-duplicating candidates when searching via Findem. 

Setup Instructions

1. Contact your Jobvite Rep to Request an API Key, API Secret and Authorized Email
2. Create Custom Fields in your Jobvite Portal
3. Connect the Integration from Within Findem

Create Service Account, Get API Key, Secret and Authorized Email

In order for the integration to work, the Jobvite Admin user will need to create a service account in their Jobvite environment if this has not already been done.

1. The Jobvite Admin will need to create a service account user (Findem’s “Authorized Email”) in Jobvite to use for a bi-directional integration.
   • The service account user:
     • must have a real company email address
     • cannot be an employee
       • In the event that the employee leaves or is no longer a Jobvite Admin, the integration will break and a new account will need to be set up.
     • must have the Admin user role in Jobvite
     • must “accept” the Jobvite account invitation
   • Recommended: jobviteapi@ 
     
   • NOTE: This service account user can be used for multiple integrations.

In addition, Findem requires an API key, API secret, Authorized email and Service URL from Jobvite. To get this required information, you'll need to contact your Jobvite representative. They'll provide you with these details. You'll then need to plug in the information to Findem (directions below).

1. The Jobvite Admin will need to submit a ticket in Jobvite’s Help Center to request a Findem API key and secret, as well as the Service URL.
   • This user must be a Jobvite “Named Support Contact” for their company in order to submit the request.
2. Jobvite will ask for the following information:
   • Vendor Name or Connected System:
   • Endpoints:
   • Environment:
   • User Email:
3. You'll need to provide the following as a response:
   • Vendor Name or Connected System: Findem (https://www.findem.ai/)
   • Endpoints:
     • GET/POST/PUT Candidate
     • GET/POST/PUT Contact
     • GET Workflow
     • GET Disposition
     • GET Job
     • GET Employee
   • Environment: Production and Staging (for initial testing)
   • User Email: This should be the service account user email address created in the steps above

When contacting your rep, you must request the API key and secret are given the following API permissions:

Employee	Get
Candidate	Get, Update, Create
Jobs	Get
Contacts	Get, Update, Create
Interviews	Get, Create, Update
Language	Get
Region	Get
Timezone	Get
Location	Get
Workflow	Get
Disposition	Get
Currency	Get
Custom Fields	Get
Departments	Get
Category	Get
Work history	Get
Education	Get
Currency	Get
Role	Get

Finally, you'll need to provide the rep with an authorized email you'd like to be associated with the API request. This should be the Admin user's email.

Below is a sample email body you can use to streamline contact with your rep. We recommend CC'ing any technical or implementation contacts who may be of assistance if needed.

Hello!

We are attempting to complete an integration with findem.ai and need an API key and secret generated. The required API permissions are as follows: 

• GET/POST/PUT Candidate
• GET/POST/PUT Contact
• GET Workflow
• GET Disposition
• GET Job
• GET Employee

The authorization email I want to associate with the API activity is [admin email here].

Please reply to this email with the requested information. I've CC'ed [any applicable contacts] who may help answer any technical questions or concerns. 

Thank you.

Create Custom Fields in Your Jobvite Portal

After you've sent the request to your rep for the API information, head to your Jobvite portal to create custom Findem fields for Source and SourceType (e.g. 'Career Site', 'Job Board', etc.)

Connecting Jobvite in Findem

To finish the connection from within Findem, you need to have received the API information from your Jobvite rep:

1. Log in to Findem and navigate to Admin > Integrations. From the Connect ATS menu, click Manage.
   
2. Locate Jobvite from the list and select.
   
3. Fill out the required fields with the information received from your rep.
   

Field Mapping

When exporting data and objects from your Jobvite ATS to Findem, use the table below to ensure you have accurate mapping.

Findem Field	Jobvite Object	Jobvite Field Name
Candidate Name	Candidate	firstName + lastName
Work Experience	Candidate	NA
Company	Candidate	companyName
Location	Candidate	location
Title	Candidate	title
Email	Candidate	email
Education	Candidate	NA
Tags	Candidate	custom_fields
Attachments	Candidate	resume
Notes	Candidate	comments
Activity Feed	Candidate	NA
LinkedIn URL	Candidate	comments, custom_fields
Findem Profile URL	Candidate	comments, custom_fields
Send Email	Candidate	sendEmail
Phone	Candidate	mobile

Candidate Volume

Findem recommends that a candidate population of a million records will take approximately 5 days to load. If you have approximately a million candidate records, please make that clear to the Findem project team to help set expectations for candidate loading.

How long does it take for data to synchronize? 

Task	Time to synchronize
Export candidates	30 minutes
Import requisitions/candidates	1 hour + Indexing time
Live applications	2 hours
Notes/attachments/tags (if available for this ATS)	2 hours

In some rare cases, data may take up to 2 hours to sync.