How can we help you?

I use CareerBuilder Employment Screening. What does the integration look like? How do I enable it?

Integration Overview:

  • Web Hook used to trigger integration.
    • When candidate marked as hired.
  • API Key used to call API for additional information.
  • Custom candidate fields used to store location information, package information and client codes.
  • When integration is initiated, email is sent to candidate with link to complete consent and disclosure.
  • Once candidate completes consent, CBES sends “Background Check In Progress” status to activity feed.
  • Once CBES completes the order, we send “Background Check Complete” status to activity feed.                 

Generating the API Key

  1. Once logged in, click on “Configure”, the gear symbol (this also opens the “Configure” page). 

  1. Click “Dev Center”.

 

 

  1. Click “API Credential Management”.

  1. Click “Create New API Key”.
  2. Enter/select the below values and then click the button at the bottom.
    1. Description: “CBES
    2. Type: “Harvest
    3. Click: “Create

  1. Click the arrow to expand the “Candidate” section. Check the “POST: Add Note” check box and then click update.

Creating the Web Hook

  1. Click on “Configure”, the gear symbol (this also opens the “Configure” page).

  1. Click “Dev Center”.

 

 

  1. Click “Web Hooks” in the left menu, and then click “Web Hooks” from the right menu.

 

  1. Create A New Web Hook: Fill out the appropriate fields (see image for reference).

a)     Name this web hook: “Send to CBES

b)     When: “Candidate has been hired

c)     [Export to] Endpoint URL: https://atsservices.auricosecure.com/atsservices/v1/GreenHouse

d)     Secret Key: “Greenhouse

e)     Error recipient email: (leave blank)

f)      Disabled: No

g)     Then click “Create Web Hook”.

 

Configuring Custom Fields

(Location, Package and Client Codes)

  1. Click on “Configure”, the gear symbol (this also opens the “Configure” page), and then click “Custom Options”.

  1. Under “Company Custom Fields”, click “Candidates”.

  1. Click “+ Add Field”.

 

  1. You will need to add fields for “CBES Location”, “CBES Package” and any “Client Code(s)” the client uses.

CBES Location

a.    Field: “CBES Location

b.    Description: “Location in WebACE

c.    Type: Click “Single select” from dropdown menu

d.    Options: “(CustomerID)|(Location Name)(separated by a pipe)ex.: “12345|Aurico Sub Location”

* Multiple locations will have each location listed as a new line in the Options box (hit the enter key after each previous location)

e.    Skip “Create new email token” and “Mark Private”. (Leave these boxes unchecked.)

f.    Click Save” at the bottom.

 

CBES Package

a.    Field: “CBES Package

b.    Description: “Package in WebACE

c.    Type: Click “Single select” from dropdown menu

d.    Options: “(CustomerID)|(Package Name)(separated by a pipe)ex.: “12345|Aurico Package Name”

* Multiple locations will have each location listed as a new line in the Options box (hit the enter key after each previous location)

e.    Skip “Create new email token” and “Mark Private”. (Leave these boxes unchecked.)

f.    Click Save” at the bottom.

 

CBES Client Code(s)

(may have none or 1+; each client code will get its own field entry) 

  1. Field MUST be labeled: “Client Code”. Subsequent client codes MUST be labeled “Client Code2”, “Client Code3”, etc. (There is space between “Client” and “Code”, but there is no space between “Code” and the number after it.)
  2. Description: (Optional)
  3. Type: Click “Single select” from dropdown menu
  4. Options: “(Client Code Option)

* Multiple options will have each option listed as a new line in the Options box (hit the enter key after each previous code)

  1. Skip “Create new email token” and “Mark Private”. (Leave these boxes unchecked.)
  2. Click Save” at the bottom.

 

(Configuring Custom Fields, continued)

 

CBES Client Code(s)

(may have none or 1+; each client code will get its own field entry)

a.    Field MUST be labeled: “Client Code”. Subsequent client codes MUST be labeled “Client Code2”, “Client Code3”, etc. (There is space between “Client” and “Code”, but there is no space between “Code” and the number after it.)

b.    Description: (Optional)

c.    Type: Click “Single select” from dropdown menu

d.    Options: “(Client Code Option)

* Multiple options will have each option listed as a new line in the Options box (hit the enter key after each previous code)

e.    Skip “Create new email token” and “Mark Private”. (Leave these boxes unchecked.)

f.    Click Save” at the bottom.

 

 

 

Placing the Order

  • Go to Candidate’s Profile
  • Click on the “Details” tab
  • Be sure the following fields are filled out (not left blank):
    • Candidate Email Address
    • CBES Location
    • CBES Package
    • Client Code(s) (Optional; Max of 4)
    • Recruiter

 

1.Click on tab: “On (#) Job(s)

2.Click on “Offer Details” side tab

3.Click on “Mark Candidate as Hired

4.Pop-up window “Offer Accepted” will appear. Fill out as necessary. For testing, scroll to bottom and just click “Save”.

5.Candidate’s profile will update with a new blue box and is marked “Hired”.

Statuses and Results URL

  • Statuses will post back to the Candidate’s “Activity Feed” tab.
  • First status posted when CBES receives the order from Greenhouse. The status will say “SUCCESS”.

The following set of slides displays the candidate’s user experience on the WebACE® Platform.

  • Once the invitation email has been received, the candidate clicks the link, which redirects to CBES’s “Candidate” Interface
  • The candidate logs into WebACE® by using the credentials provided via email

These images display the candidate’s user experience on the WebACE® Platform.

“In Progress” & “Complete” Statuses with Result URLs

  • Subsequent statuses will update into the candidate’s Activity Feed tab as the order progresses through WebACE®.
  • In Progress” will post when the invitation is completed by the candidate and the order is being worked on in WebACE®. This is accompanied by a ResultURL to view the order in WebACE as it is being worked on.
  • Complete” will post when the order is completed in WebACE® and is ready to view. This status will be accompanied by either a “Clear” or “Review” adjudication with a ResultURL to view the completed order results.