How can we help you?

Atlantic Employee Screening

With a seamless integration between Greenhouse and Atlantic Employee Screening, it’s never been quicker or easier to remain updated on applicants from pre-hire to post-hire. Integrating Atlantic’s rapid background screening with the power of Greenhouse is simple and will save you time, money, and the worry of waiting around to hire the best candidate.

Greenhouse Recruiting’s integration with Atlantic Employee Screenings allows you to easily screen applicants and receive accurate, compliant reports all in one spot with little to no data entry.  In this article, we will cover how to: 

  • Configure User Setup Permissions in Greenhouse Recruiting
  • Retrieve Atlantic’s Endpoint URL and Secret Key
  • Enable Greenhouse/Atlantic Integration
  • Retrieve the results via a link that will bring you to our Gateway 2.0

Configure User Setup Permissions in Greenhouse Recruiting

In order to enable the Greenhouse/Atlantic integration, you will need the developer permission Can manage ALL organization’s API Credentials

Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon  https://lh4.googleusercontent.com/a_djzyyhccQcZL44s4mwgKCQ8MosRVAEF4bOHLBiRVYamMoGYp48Ianyb8W_N_JvUEnjbTxjCvtY9f_pdvct0HxG1TpUGHwXqMIOMbHDMJtNizkAqY-2a0uFkLHw9fzOYzqym90 > Users > Your Name)

https://lh4.googleusercontent.com/Lp2-UCXJlWQnFZ4Jl8Ku_ii5eB76-KQSjH3pV06A-PuatbmWN8WtV7G8bOIXoDeFE5gFIE3tXEXVCZ-wi2yN7VhwmpqOH6Rl201y1zyF1J5aberG7s-xxeWeYMsRrokTBWMrh7o

The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu. 

Select Can manage ALL organization’s API Credentials so that a check is in the checkbox. When finished, click Save.

https://lh6.googleusercontent.com/FTTda0ojf3CIu_vjcDPbxTECl0v6XLdNWau-CwzAidoOIWHeOO-0GrwNMdfatKnv2lO_IsJme4xBx2H3-aWWDNQJAqO1QwrzqQM6shhYRga-Ihc-6Q6NM7iV8vQpBW0aLVl8S3I

Repeat as necessary for any other user that should have access to set up the integration.

Retrieve Atlantic’s Endpoint URL and Secret Key

Before enabling the Greenhouse/Atlantic integration, Greenhouse will need two pieces of information: 

  • Atlantic’s Endpoint URL
  • Atlantic’s Secret Key 

To retrieve this information please reach out to our Atlantic Customer Success team. When you receive both the Endpoint URL and the Secret key, it will be entered when creating a webhook.

Enable Greenhouse/Atlantic Integration

With Atlantic’s endpoint URL and Secret Key copied, and your Greenhouse user permissions enabled, you are ready to enable the Greenhouse/Atlantic integration.

To enable the integration, click the Configure icon https://lh4.googleusercontent.com/a_djzyyhccQcZL44s4mwgKCQ8MosRVAEF4bOHLBiRVYamMoGYp48Ianyb8W_N_JvUEnjbTxjCvtY9f_pdvct0HxG1TpUGHwXqMIOMbHDMJtNizkAqY-2a0uFkLHw9fzOYzqym90 in the upper right-hand corner and navigate to Dev Center on the left-hand panel.

 

https://lh5.googleusercontent.com/FE8M4wPSZdQUsHnIYA9uYIHSD3DlIghnMf0EX3X6EtEN99yvnizh_dj9uvO-TGodTmQNW63JV2XbOAHWda3cmkQzYP8LJihBL34WM7YDVR81E6E3gMjwwfTtq-Rj33oR5EnJg5E

 

From the Dev Center page, click Web Hooks. Click Web Hooks from the subsequent page.

 

https://lh4.googleusercontent.com/PolsG6rlImIijjzJnpCRqO8LJqtdLbzpvpkPJ6fMBCDH3yAde47q53uzCURXIkjEGQwM3Ade9LJXPjkooZqj7U5FHZYpIZD_hy54t707c37d5aYV-25JtbrdOnj5IIvSYW44Fhg

You will be directed to a new page where you Create a New Web Hook. From this page provide the following details:

  • Name: we suggest Atlantic Integration
  • When: Be sure to select the right web hook so that the web hook fires at the appropriate event in Greenhouse – “Candidate has changed stage”
  • Endpoint URL: The Endpoint URL received from the Atlantic Customer Success team
  • Secret Key: The Secret Key received from the Atlantic Customer Success team

When finished, click Create Web hook.

https://lh6.googleusercontent.com/-AYknBr2yGdx1vOhpfYXGUe_GNYR6NLYjClsGka8K_DCRx9Hv9liXNwvA3pwqgbwKLdgzMlTIm_PrrWivOrJfBXzxYVxffKXjOPu1Xaq3dvLO_F4Mh-iqGhGVlYKOyU8KwNjxsk

 

 

Create a Harvest API Key for the Greenhouse/Atlantic Integration

To create a Harvest API key for the integration, click on the Configure icon Screen_Shot_2018-05-24_at_5.31.51_PM.png in the upper right-hand corner. Navigate to Dev Center on the left-hand panel.

From the Dev Center page, click API Credential Management.

https://lh4.googleusercontent.com/kxsSIdHEkHlvRXfehBl-_KjWlWjgRghbQPck8B6n6FfAqgvYBImq1x0NX1L2mg4jopOibaIlL6ObaZo8D_QAdUMT7R4iexCeZEbNvLmmjXybeRnq6X0AdYzL-ZoYC8sNLHZNdug

 

From the API Credential Management page, click Create New API Key to generate the API key for Atlantic Employee Screening.

 

https://lh5.googleusercontent.com/3jo3KNGUwntakIb6Nbkzhkmxn9LquiQGxWLtqfg4yL6vygx0gq-WpYrZBqjhPFSjq21rKxKprKjd0VjK6jftdWBoB2NErNbq_KTnGZaoPya7HsC4YrpB7VfkW_5OLNfu5oFWilY

 

From the Create new credential dialog box, give your API key a name and select Harvest from the Type dropdown menu. When finished, click Create.

 

A screenshot of a cell phone

Description automatically generated

 

On the Manage API Key Permissions page, you must check the following boxes:

Activity Feed

Applications

Candidates (GET: Retrieve Candidates, PATCH: Edit Candidate, and POST: Add Note)

Custom Field Options

Custom Fields

Departments

Education

Job Stages

Offices

User Roles

Users (GET: Retrieve User and GET: List Users)

 

When finished, click Update.

 Your Harvest API key for the Greenhouse/Atlantic integration is created and configured. Provide your Harvest API key to your Atlantic onboarding team so they can set up the integration.

How to use the Atlantic Employee Screening Integration with Greenhouse


 

Upon implementation of the integration, moving the applicant’s stage into Background Check will prompt an e-mail to be sent to the applicant in order to have them fill out personal information, via the QuickApp. This will also be where they give authorization for the background check. Alternatively, you can enter the information yourself if you prefer paper authorization forms. You will receive an e-mail once the order has been sent to our system, as well as when it is completed.

 

A screenshot of a cell phone

Description automatically generated

 

The link will bring you to our Gateway 2.0, where you will be prompted to log-in with the credentials given from our Atlantic team. Once you log in, you will arrive to the completed report with compliant, accurate results.


After using the integration, you may decide you want to share more info between Greenhouse and Atlantic If you would like additional information transferred over, please reach out to Atlantic Success Team with a list of items to add!

 

Need Help?

For any questions about pricing, common errors, or questions about how the integration can assist your hiring processes, call our office at 877-747-2104.

 

Please contact ddavis@atlanticscreening.com for troubleshooting assistance regarding the integration.