Skip to main content

Jobvite Integration

Updated this week

Integrating Yardstik and Jobvite allows you to order background checks directly from Jobvite by moving candidates to a designated workflow step. Results and status updates flow back into Jobvite automatically.

Setup requires a few steps in both Yardstik and Jobvite, including a support ticket to the Jobvite team.


Step 1: Gather Your Information from Yardstik

  1. Navigate to Developer Tools > Integrations

  2. Click Get Started on the Jobvite integration card

  3. Click Generate to create a Yardstik API Key — copy and store it in a secure place. If you lose your key, you will need to generate a new one.

  4. From the integration card, copy the following — you'll need all of these for the next step:

    • Yardstik Account ID

    • Account Package Names — the names of the packages you want available in Jobvite (you may have more than one and they are available in the View Packages button on the integration card)

    • Callback URL — available on the integration card. When submitting to Jobvite, append your Account ID to the end of the URL (e.g., https://api.yardstik.com/jobvite/api/orders/{your-account-id})


Step 2: Submit a Support Ticket in Jobvite

In the Jobvite platform, hover over the help menu and select Submit a Ticket. Let the Jobvite support team know you'd like to activate the Yardstik integration and provide the following:

  • Your Yardstik API Key

  • Your Yardstik Account ID

  • Your Account Package Names

  • Your Callback URL (with your Account ID appended)

  • Workflow State: Yardstik Screening

The Jobvite team will configure the integration on their side, including setting up the required custom fields and workflow step. Once complete, they will provide you with a Jobvite API Key and a Jobvite Secret Key.


Step 3: Complete Setup in Yardstik

  1. Back in the Yardstik integration card for Jobvite, enter the Jobvite API Key and Jobvite Secret Key provided by Jobvite

  2. Click Update

  3. Toggle the integration on

Setup is complete.


Configure Packages in Jobvite

Before ordering background checks, you need to confirm your Yardstik packages are configured in Jobvite. As part of the integration setup, Jobvite support configures the following custom fields on your account:

Requisition-level:

  • Yardstik Package Name — a single-select dropdown where you select which Yardstik screening package to apply to candidates in the requisition. The values in this dropdown must exactly match your Account Package Names in Yardstik.

Candidate-level (these populate automatically as reports progress):

  • Yardstik Report Status — current status of the background check

  • Yardstik Invitation Sent Date — date the invitation was sent to the candidate

  • Yardstik Invitation Completed Date — date the candidate completed the invitation

  • Yardstik Report Completed Date — date the report was completed

  • Yardstik Report URL — direct link to view the full report in Yardstik

Note: For the Yardstik Report URL to be clickable in Jobvite, app.yardstik.com must be added as a trusted domain in your Jobvite configuration. Jobvite support typically handles this during setup.


Ordering a Background Check

  1. Create or open a Requisition in Jobvite

  2. In the Yardstik Package Name field on the requisition, select the package you want to use

  3. Add a Candidate to the requisition (at minimum: first name, last name, and email address)

  4. Move the candidate to the Yardstik Screening workflow step

  5. In approximately 15 seconds, a response from Yardstik will appear in the Application Details confirming the invitation has been sent and the report has been created

  6. The candidate will receive an email invitation to complete their background check


Viewing Results in Jobvite

As the background check progresses, status updates are sent to Jobvite automatically on each report status change. The candidate-level custom fields update in real time:

Custom Field

Description

Custom Field

Description

Yardstik Report Status

Current status of the report (e.g., created, processing, clear, consider, pre_adverse)

Yardstik Invitation Sent Date

Date the invitation was sent to the candidate

Yardstik Invitation Completed Date

Date the candidate submitted their screening

Yardstik Report Completed Date

Date the report reached a final status

Yardstik Report URL

Direct link to view the full report in Yardstik

Click the Yardstik Report URL to navigate directly to the report detail view in the Yardstik application.


Integration Additional Notes

  • Reports are invite-based — Jobvite does not pass candidate date of birth or SSN, so all background checks require the candidate to complete an invitation before the screening can proceed.

  • Packages are not automatically synced — Packages must be configured in Jobvite to match your Yardstik Account Package Names. If you add or change packages in Yardstik, you can change them in the Admin Custom Field "Yardstik Package Name" within the Requisition object.


Errors and Support

If there is an error creating a background check, an error message will appear in the Yardstik Report Status field on the candidate record in Jobvite.

For assistance, contact [email protected] or visit the Yardstik Support Page.

Did this answer your question?