Sapia.ai integration

Sapia.ai reduces the friction in your hiring process, making it faster and fairer, with a world-class candidate experience.

Sapia.ai’s Smart Interviewer is a revolutionary smart touch interview process, providing insights for both candidates and hiring teams. With Sapia.ai, you will strengthen your employer brand while realizing immediate efficiency gains. Our AI is ethical, explainable, and backed by peer-reviewed scientific research.

Greenhouse Recruiting's integration with Sapia.ai allows you to seamlessly add Sapia.ai’s Smart Interviewer as a stage to a job interview plan.

Set up the Sapia.ai integration

Create a Harvest API key

To configure the Sapia.ai integration, you’ll need to create a Harvest API key.

Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Sapia.ai integration.

Credentials

In the Create New Credential box, make the following selections:

• API Type: Harvest
• Partner: Sapia.ai
• Description: Sapia.ai Harvest API Key

Permissions

Verify that the following permissions are selected for the Sapia.ai integration:

• Applications
  • Get: Retrieve Application
  • Patch: Update Application
  • Post: Advance Application
• Candidates
  • Get: Retrieve Candidate
  • Post: Add note
• Custom Fields
  • Delete: Delete custom field
  • Get: Get custom fields
  • Patch: Update custom field
  • Post: Create custom field
• EEOC
  • Get: Retrieve EEOC Data for Application
    Note: This permission is only applicable for US hiring.
• Jobs
  • Get: Retrieve Job
• Job Stages
  • Get: List Job Stages for Job
  • Get: Retrieve Job Stage
  • Get: List Job Stages
• Users
  • GET: Retrieve User

When finished, click Save.

Your Harvest API key for the Sapia.ai integration is created and configured.

Copy the API key to provide to Sapia.ai.

Provide your Harvest API credential to Sapia.ai

Contact your Sapia.ai representative to provide your Harvest API key securely. At the same time, Sapia.ai will inform which Sapia.ai stage/ region environment needs to be activated by Greenhouse.

Sapia.ai will securely provide you with a Sapia.ai’s API key.

Below are the available Sapia.ai‘s stages/environment:

• Sapia.AI - EU -. for clients in EMEA region
• Sapia.AI - AU - for clients in APAC region
• Sapia.AI - US - for clients in US region

Provide Sapia.ai API key to Greenhouse

Click here to open a ticket with Greenhouse Technical Support, requesting for the Sapia.ai integration to be enabled and specifying which Sapia.ai stage/environment to be enabled within the ticket.

Only when requested by Greenhouse Technical support, provide the Sapia.ai’s API key securely.

More info here.

Add the Sapia.ai stage to an interview plan

Once the integration is enabled for your organization, you will be able to add Sapia.ai as an interview stage.

Setting up webhooks for candidate and application deletions

To configure the Sapia.ai integration, you’ll need to create webhooks for candidate and application deletions.

Follow the steps in this article to create a webhook.

Delete Application webhook

Name this Webhook: Use a clear name such as Sapia Delete Application
When: Delete Application
Endpoint URL: enter the correct endpoint URL provided by Sapia.ai
Secret Key: use the Harvest API Key generated/used for Sapia.ai
Enter recipient email (Optional): Enter an email address to receive notifications in case of webhook failures.

Advanced Settings > Basic Authorization Credentials:
Username: enter the Sapia API key that was provided
Password: leave blank

Delete Candidate webhook

Name this Webhook: Use a clear name such as Sapia Delete Candidate
When: Delete Candidate
Endpoint URL: enter the correct endpoint URL provided by Sapia.ai
Secret Key: use the Harvest API Key generated/used for Sapia.ai
Enter recipient email (Optional): Enter an email address to receive notifications in case of webhook failures.

Advanced Settings > Basic Authorization Credentials:
Username: enter the Sapia API key that was provided
Password: leave blank

Maximum Attempts: 6
Deactivated?: No

Note: Applications can only be assessed by Sapia.ai if a phone number is included in the candidate application.

To ensure integration is functioning correctly, you'll need to edit your configured job post settings to ensure phone numbers are required for your candidate applications.

To start, navigate to your job (Jobs > select a Job > Job dashboard) and click Job Setup. Click the Job Posts tab and then, click the edit icon.

Scroll to Basic Application Information and ensure Required is selected next to Phone Number. 

You can also change this requirement in bulk for a number of active jobs. Follow the steps in this article to learn more.

Use the Sapia.ai integration with Greenhouse Recruiting

Send an interview

Once the Sapia.ai stage has been added, you can send an interview to a candidate by selecting the Send Test button next to the Sapia.ai interview stage. The button will appear directly within the candidate profile. 

In the subsequent dialog box, select the correct test from the dropdown list, and select who should review the result.

An email will then be sent to the candidate with a request to complete the interview. Greenhouse will display Sent next to the interview stage.

View candidate results

Once the candidate has submitted their interview, a score will be presented in the candidate record. Depending on your notification settings, you may also receive an email notification from Greenhouse.

Click on the appropriate Sapia.ai stage to open the Interview Kit.

On the subsequent page, you will be able to find further information, including the recommendation (Yes/Maybe/No) and if any warning was detected.

Click View Report to view the interview answers provided and an in-depth Talent Insights report on Sapia.

Additional resources

For additional information not covered here, reach out to support@sapia.ai or visit the Sapia.ai support center.