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:
Open Admin area.
Scroll down to Integrations.
Find the Ashby integration and click "Configure".
Click "Enable integration"
Now, follow the instructions below to create an Ashby API Key
In Ashby:
Open Admin area.
Click "API Keys" in the navigation menu on the left.
Click the "New" button on the top-right
Enter a Name for the API Key (this is just to help you label it)
Leave Integration Partner blank (this field is optional)
Hit "Create API Key"
Copy the API Key and head back to Humaans
In Humaans:
Paste in the Ashby API Key you've just created.
Click "Save"
Now, we'll need to tell Ashby about the Request URL and Secret Token generated by Humaans
Copy the Request URL and head back to Ashby
In Ashby:
Click "Webhooks" in the navigation menu on the left
Click the "New" button on the top-right
Under "Webhook Type", select "Application Updated"
Paste in the Request URL from Humaans
Back In Humaans, copy the Secret Token
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 |
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.