It's essential that you have the correct permissions on both Humaans and Ashby when setting up the integration. Otherwise, the connection will fail.
Read permissions within Ashby is required in the following scopes:
Candidate (candidate.info)
Department (department.list)
Jobs (jobPosting.list)
Location (location.info)
Offer (offer.list)
Hiring process metadata (customFields.list)
In Humaans:
Click Integrations in the left-hand side menu.
Open Ashby by clicking Configure.
Click Enable integration.
To create an Ashby API key, follow these steps in Ashby:
Click Ashby API, followed by API Keys in the left-hand side menu.
Click New in the top right-hand corner.
Add a name to the API Key field. This will simply work as a label.
Leave Integration Partner blank. This field is optional.
Click Create API Key.
Copy the API key which you will add in Humaans.
Return to Humaans:
Click Integrations in the left-hand side menu.
Open Ashby by clicking Configure.
Paste Ashby API key you've just created.
Click Save.
Take note of the Request URL and Secret Token generated by Humaans.
In Ashby:
Click Webhooks in the menu on the left-hand side.
Click New in the top right-hand corner.
Under Webhook Type, select Application Updated.
Paste the Request URL and Secret Token from Humaans.
The will activate the integration. Moving forward, a candidate marked as hired in Ashby will appear in Humaans in the New hires tab.
Fields
Below is the default list of fields that are imported into Humaans from Ashby. You can enable and disable all fields as needed, except for greyed fields. These are required, and include first name, last name, job title, and personal email address.
You can add new custom fields and custom compensation types.
Ashby field | Humaans field |
Name | First name, last name |
Personal Email | Personal email |
Personal Phone | Personal phone |
Start Date | Employment start date |
Job Title | Job title |
Department | Department |
Location | Place of work |
Salary | Salary |
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.