Skip to content
imper.ai

Integrating SmartRecruiters with imper.ai

Overview ​

This integration connects SmartRecruiters with imper.ai to secure interviews throughout the hiring process. It enables protection and verification for interviews that are managed and scheduled directly within SmartRecruiters, helping prevent impersonation and candidate fraud.

NOTE

The setup requires SmartRecruiters admin access to complete the configuration steps. To connect and manage the SmartRecruiters integration in imper.ai, users must have admin role.


Setup ​

The setup moves between both platforms: start in imper.ai to open the connection dialog, generate an OAuth credential in SmartRecruiters, then return to imper.ai to complete the connection.

Step 1: Open the SmartRecruiters integration in imper.ai ​

  1. In the imper.ai admin interface, go to Integrations.

  2. Find SmartRecruiters under HR Systems and click Connect.

The dialog lists the setup steps and the exact scopes you need to select in SmartRecruiters, each with a copy button. Leave it open — you return to it in Step 3.

The SmartRecruiters Integration dialog in imper.ai, listing the setup steps, the seven required scopes, and the Client ID and Client Secret fields.

SmartRecruiters Integration dialog in imper.ai

Step 2: Generate an OAuth credential in SmartRecruiters ​

Log in to your SmartRecruiters account as an administrator.

  1. Open Settings, and under Administration, click Apps & integrations.

The SmartRecruiters Settings page, with Apps & integrations listed under the Administration column.

  1. Select the Credentials tab, then click New credential.

The Credentials tab of the Custom Applications page, with the New credential button in the top right.

  1. Select OAuth client ID, then click Next.

The New Credential screen, with OAuth client ID selected and the API key option below it.

  1. Fill in the New OAuth Credential form:

    • Credentials name — a name that identifies the integration, for example imper.ai.

    • System role — select Admin.

    • Description — optional, for example imper.ai application.

The New OAuth Credential form, showing the credentials name set to imper.ai, the system role set to Admin, and the scope table below.

  1. Under Scope, select the following seven scopes:
User promptScope
Access Candidatescandidates_read
Manage Candidate Status and Propertiescandidates_manage
Access Jobsjobs_read
View webhook subscriptionswebhooks_read
Create new webhook subscriptionwebhooks_write
Delete webhook subscriptionwebhooks_delete
View, create and delete webhook subscriptionswebhooks_manage

Once all seven are selected, the counter above the table reads Selected (7).

The four webhook scopes selected in the SmartRecruiters scope table.

The four webhook scopes selected

  1. Click Generate at the bottom of the page.

  2. Copy the Client ID and Client Secret from the pop-up, then click Done.

IMPORTANT

The client secret is shown only once. Copy both values before closing the pop-up. If you lose the secret, generate a new credential.

The Credentials pop-up in SmartRecruiters, showing the generated Client ID and Client Secret with copy buttons.

Generated credentials — values redacted

Step 3: Connect SmartRecruiters to imper.ai ​

  1. Return to the SmartRecruiters Integration dialog in imper.ai.

  2. Paste the Client ID and Client Secret into the matching fields.

  3. Click Connect to complete the process.

imper.ai confirms the connection, and SmartRecruiters is marked as connected on the Integrations page.

The imper.ai Integrations page showing a SmartRecruiters connected successfully message and the SmartRecruiters card marked as connected.

Integrations Page: SmartRecruiters connected