Traitify is a personality data company that helps companies easily collect personality data from candidates and employees faster than ever before and with exceptional candidate experience. Companies then use the data to make smarter hiring decisions and give value back to their people.
Greenhouse Recruiting’s integration with Traitify allows users to enable a Traitify’s assessment on a job. Once a candidate completes an assessment, users can also view the candidate's result and fit score on their profile and Activity Feed.
Create a Harvest API key for the Traitify integration
To configure the Greenhouse Recruiting / Traitify integration, you'll need to create a Harvest API key.
Follow the steps in this article to create the key, and verify that the credentials and permissions below are selected when configuring the Traitify integration.
Credentials
In the Create New Credential box, make the following selections:
- API type: Harvest
- Partner: Traitify
- Description: Traitify Harvest API key
Permissions
Verify that the following permissions are selected for the Traitify integration:
Applications
- GET: Retrieve Application
- PATCH: Update Application
- POST: Move Application
Candidates
- GET: Retrieve Candidate
- PATCH: Edit Candidate
- POST: Add Note
Custom Field Options
- GET: Custom field options
- POST: Create custom field options
- DELETE: Remove custom field options
- PATCH: Update custom field options
Custom Fields
- GET: Get custom fields
Job Stages
- GET: List Job Stages for Job
User
- GET: List Users
Create a custom job field for the Traitify fit type
Follow the steps in this article to create the custom job field.
When you get to the Create New Job Field window, add the following information:
- Field: Tratify Fit Type
- Type: Single select
Create a webhook
The next step in setting up the integration is creating a webhook.
Follow the steps in this article to create your webhook. Use the values listed below to configure the webhook(s).
- Name: Tratify Assessment
- When: Candidate has submitted application
- Endpoint URL: https://app.traitify.com/api/greenhouse/applicants
- Secret Key: sent from Tratify
- Error recipient email: integrations@tratify.com
Expand the Advanced Settings dropdown menu and add the following information:
- Username: sent from Tratify
- Password: sent from Tratify
- Disabled: No
Add Traitify Assessment stage on a job
When adding the Traitify assessment to a job, you can optionally add a Traitify Assessment Complete stage to the job.
When the Traitify Assessment Complete stage is present on a job, Traitify will move candidates to this stage. If the stage isn’t present, the candidate will stay in their existing status once the assessment is complete
The stage can be added when creating a new job or when editing a job.
Start by clicking Add Stage on the Interview Plan page.
Add Traitify Assessment Complete, then click Add to save the changes.