Skip to content
Docs

Linking your SmartRecruiters account

Prerequisites

Before getting started, please carefully read the following to make sure you fulfill all requirements for the integration to work:

  • You should have “Admin Access” to your SmartRecruiters instance.
    If your account does not have the assigned User role of “Admin” you won’t be allowed to create the necessary credentials.
  1. Log into SmartRecruiters and go to “Settings” in the top right corner:
  2. Ensure that your account is labled with “Admin Access” underneath your account name:image (10).png

Sign in with SmartRecruiters

  1. Click on the “Sign in with SmartRecruiters” button:

  2. Log in to SmartRecruiters. On the next screen, click on “ALLOW ACCESS”:

Screening questions

SmartRecruiters is currently moving from an API key based authentication model to an OAuth (user login) flow. You completed the OAuth flow in the previous step.

Currently, the OAuth flow does not support reading or writing of screening questions. An additional API key has to be provided for this functionality to be available. If you do not see the prompt below you can skip this step.

To set up an API key follow the steps below:

  1. Open this configuration page in SmartRecruiters (Settings > Administration: Apps & Integrations > Credentials).
  2. Click on “New Credential”.
  3. Select “API key” and click “Next”.
  4. Enter a name and description for the new credentials. For the System role select “Extended”. Then press “Generate” to create the API key.
  5. To complete the API key setup, copy the key from the window that opens and paste it into the connection flow.

Hiring source

The last step in the connection process is optional. If you are asked to set up a source, please follow the instructions in the connection flow.