Skip to main content

ICIMS + Certn Integration Setup

  • Updated

Overview

The ICIMS + Certn integration allows hiring teams to initiate, track, and complete background checks directly within the ICIMS ATS platform.

Instead of switching between systems or manually triggering checks, recruiters can move a candidate to a configured stage in ICIMS and Certn automatically initiates the background check. Status updates and report access sync back into ICIMS, giving your team real-time visibility without disrupting workflow.

With this integration, you can:

  • Automatically trigger background checks based on stage
  • View live status updates inside ICIMS
  • Access reports via PDF or secure Certn portal
  • Assign checks to a default group within Certn for centralized management
  • Support compliant, post-offer, candidate-initiated screening workflows

The result is faster hiring, stronger compliance alignment, and fewer manual steps for your team.

Setup

Step 1: Create one or more packages of checks to use in ICIMS

  1. Login to Certn.
  2. Navigate to “Packages” and select “New Package”.
  3. Give the package a name and description (make note of the name for Step 3).
  4. Enable the “Mark this package for ATS use” switch.
  5. Specify any tags you wish to apply to the package for auditing purposes.
  6. Select the one or more checks you wish to be added to the package.
  7. Review details of package.
  8. Select “Save package”.
  9. Now that the package is made, open it up and make note of the package ID in the package URL, where the URL looks like: https://client.certn.co/<ca | uk | au>/package/<package id here>/
  10. Repeat steps in this section for any additional packages you wish to use in your ICIMS ATS.

Step 2: Initiate Integration Setup with ICIMS

  1. Submit a request to your ICIMS account manager to set up an integration with Certn.
  2. ICIMS will assign a Customer Integration Consultant to work on setting up this integration. ⚠️ Please note - ICIMS states this process can take 6-12 weeks or more and is not dependent on any action by Certn.
  3. Request the following from your ICIMS Customer Integration Consultant:
    1. ICIMS Customer ID
    2. ICIMS Username
    3. ICIMS Password
  4. If prompted, share the exact full name & ID of the package(s) you wish to order from Certn within ICIMS.
  5. If prompted, share the Certn endpoint url: 
    1. For North America → https://api.ca.certn.co/api/external/ats/icims/webhook/
    2. For Europe/Middle-East/Africa/ → https://api.uk.certn.co/api/external/ats/icims/webhook/
    3. For APAC → https://api.au.certn.co/api/external/ats/icims/webhook/

 

Step 3: Create ICIMS integration connection in Certn

  1. Log in to Certn.
  2. Navigate to “Settings” -> “Integrations”.
  3. Select “Add” next to the ICIMS integration to open the integration details page for ICIMS.
  4. Specify the ICIMS customer ID, ICIMS username, and ICIMS password from Step 2 in their respective fields inside the integration details page.
  5. Copy the generated Webhook username & Webhook password, storing it securely.
    1. ⚠️ Important: You will not be able to access the Webhook username or password after leaving the page. Make sure these values are saved somewhere secure before proceeding.
  6. Configure your default Report URL Type preference by choosing whether ICIMS receives:
    1. A PDF report that does not require a user to login, or
    2. A secure Certn portal link that requires user authentication to view the report
  7. Configure your default Group using the “Select a group” dropdown. All ordered background checks from this package will be assigned to this specified group within your Certn instance. This will be the default group where you will be able to view all background checks when you log into Certn.
  8. Select “Save changes” to activate this integration on the Certn platform. 

Step 3: Finalize Details with ICIMS Customer Integration Consultant

To finalize activation of the integration, use a mechanism such as SendSafely to securely share final details with your ICIMS Customer Integration Consultant including:

  • The generated Webhook username & Webhook password from Certn generated in Step 2.
  • The exact full name & ID of the package(s) you wish to order from Certn within ICIMS.
  • Certn’s endpoint
    • For North America → https://api.ca.certn.co/api/external/ats/icims/webhook/
    • For Europe/Middle East/Africa/ → https://api.uk.certn.co/api/external/ats/icims/webhook/
    • For Asia Pacific → https://api.au.certn.co/api/external/ats/icims/webhook/

Integration Complete

Your Certn + ICIMS integration is now active.

Recruiters can initiate background checks from within ICIMS, and status updates and reports will sync back automatically.

If you need to adjust report types or default groups in the future, you can do so directly within Certn by editing the ATS integration connection in the same way that you originally set it up with these instructions.

Comments

0 comments

Article is closed for comments.