iCIMS + GoodTime Integration Guide

TL;DR: GoodTime integrates with the iCIMS Applicant Tracking System (ATS) in order to provide the scheduling benefits of GoodTime on top of the regular candidate and recruitment process management offered by iCIMS.  

Prerequisites:

For initial configuration, the user will need to have administrator access on iCIMS and super admin access on GoodTime.

Each GoodTime + iCIMS installation will need the iCIMS Streaming API and there is a cost associated with this through iCIMS. To purchase the license to use the Streaming API from iCIMS, please engage with your iCIMS Implementation Manager (or Account Executive) to let him/her know that you are wanting to deploy the GoodTime integration. Inform your Implementation Manager that you need the Streaming API access in the project.  You will likely need to execute an SOW with iCIMS to get an implementation resource assigned to the project. 

When meeting with your Implementation Manager, the following items should be discussed, requested or granted:

1. The Implementation Manager from iCIMS will enable GoodTime with the necessary credentials to access the Streaming API.

2. You will need to inform your Implementation Manager what fields you wish to sync using the Streaming API. A “channel” will be created to sync the specified fields.

3. The Implementation Manager will assign a CustomerId and StreamId to identify your iCIMS tenant and channel.

4. GoodTime will use the CustomerId and StreamId to access your data in iCIMS going forward.

Bins and Statuses

From iCIMS, you will need to extract and capture your list of bins and statuses that will then be ported into GoodTime to allow for integration events. Following is a sample listing of what GoodTime is requesting. Bins and statuses are created/updated and exported to you from an iCIMS resource.

Important note: "iCIMS bins & statuses" are synonymous to "GoodTime stages" and how GoodTime tracks the “status/stage” the candidate is in when scheduling.

GoodTime Configuration

Follow the steps to complete the set up for the iCIMS and GoodTime Integration

1. Grant API Access

   1. Option 1: Connect your CustomerId to GoodTime’s clientId 

      1. GoodTime’s clientId credentials are:

         1. For list/profile/search/dataStream: bsSwDDcdy7lDRJbgqPDZkswtSu8TcrUS

         2. For interview-service API/feedbackForm API:
            UmI31wQb6RXZUYRmUy7wWEjU5PvbFG7x

      2. Provide GoodTime with CustomerId (iCIMS Implementation Manager can provide)

   2. Option 2: Set up your own Client ID & Client secret & provide them to GoodTime Team in a secure manner

2. iCIMS to grant following scopes to GoodTime’s client:

   1. Data-stream:stream:read

   2. data-transfer-assembler:stream:read 

if wanting interview to sync back to iCIMS, also:

• interview-service:interview:create 

• Interview-service:interview:read

• Interview-service:interview:update

• interview-service:interview:delete

if using feedback forms, also:

• biz-collab-feedback-service:feedbackReq:rw

• biz-collab-feedback-service:forms:ro

3. Provide GoodTime with a list of Bins & Statuses

   1. Identify which statuses you want to trigger to schedule in GoodTime.

4. iCIMS to place GoodTime’s webhook address for the statuses they want to use as triggers.

   1. US GoodTime servers: https://a.goodtime.io/v2/ats/webhook/icims

   2. EU GoodTime servers: https://eu.goodtime.io/v2/ats/webhook/icims

5. Once all steps are completed, GoodTime can begin the data sync. The length of the sync is dependent on how much data is in iCIMS.

   1. The default sync is about 80K calls per an hour and includes all jobs, candidates, and users.

The GoodTime Integration leverages the iCIMS Streaming API, iCIMS Profile API and iCIMS List API.

Entities Synced and Frequency

Fields Reference - GoodTime pulls from iCIMS:

Person: (click to open)

• firstname

• lastname

• middlename

• email

• folder

• phones

• location

• resume

• updateddate

Recruiting Workflow: (click to open)

• associatedprofile

• baseprofile

• source

• sourceperson

• bin / status

• updateddate

Job: (click to open)

• jobid

• jobtitle

• folder

• hiringmanager

• recruiter

• secondaryrecruiter

• jobowner

• joblocation

• updateddate

Schedule iCIMS Candidate in GoodTime

Video clip: Scheduling a candidate for an interview

Optional Setup

If preferred, GoodTime is able to automatically advance the candidate into the next Status in iCIMS. This will occur immediately once the candidate is opened in GoodTime (For example - trigger for scheduling is “Availability Requested” → Moved immediately into “Interview scheduled”). Please inform your GoodTime Professional Services Consultant so they can appropriately set up this workflow.