Skip to main content
All CollectionsIntegrationsAshby
Enabling Ashby Integration
Enabling Ashby Integration
Updated over 9 months ago

Connect Humaans to your Ashby account to automatically import hired candidates to Humaans.

The user setting up the integration needs to have the correct permissions in both systems, otherwise the connection will fail.

In Humaans:

  1. Open Admin area.

  2. Scroll down to Integrations.

  3. Find the Ashby integration and click "Configure".

  4. Click "Enable integration"

  5. Now, follow the instructions below to create an Ashby API Key

In Ashby:

  1. Open Admin area.

  2. Click "API Keys" in the navigation menu on the left.

  3. Click the "New" button on the top-right

  4. Enter a Name for the API Key (this is just to help you label it)

  5. Leave Integration Partner blank (this field is optional)

  6. Hit "Create API Key"

  7. Copy the API Key and head back to Humaans

In Humaans:

  1. Paste in the Ashby API Key you've just created.

  2. Click "Save"

  3. Now, we'll need to tell Ashby about the Request URL and Secret Token generated by Humaans

  4. Copy the Request URL and head back to Ashby

In Ashby:

  1. Click "Webhooks" in the navigation menu on the left

  2. Click the "New" button on the top-right

  3. Under "Webhook Type", select "Application Updated"

  4. Paste in the Request URL from Humaans

  5. Back In Humaans, copy the Secret Token

  6. In Ashby, Paste in the Secret Token

The integration should now be active. When a candidate is marked as hired - that person will appear in Humaans in a "New hires" tab.

Fields

Below is a list of fields that get imported from Ashby.

Ashby field

Humaans field

Name

First name, middle name, last name

Personal Email

Personal email

Personal Phone

Personal phone

Job Title

Job title

Department

Department

LinkedIn

LinkedIn

Twitter

Twitter

Offer Start Date

Employment start date

Offer compensation

Salary amount

Offer compensation currency

Salary currency

Adding new hires as members

Candidates that get imported from Ashby will appear in the New hires tab.

This gives you a chance to review all the new hires and their information before adding them as members to your Humaans account.

To view the information of the new hire, click on the row or "Add member" link.

Review the information that has been imported from Ashby, fill out any missing fields and add the new member to your Humaans account.

Deleting new hires

If you don't want to add some new hires as members to your Humaans account, you can delete them. Click on the new hire you'd like to delete, and then click "Delete this new hire" at the bottom of the window.

Did this answer your question?