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.


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

  • API type: Harvest
  • Partner: Traitify
  • Description: Traitify Harvest API key


Verify that the following permissions are selected for the Traitify integration:


  • GET: Retrieve Application
  • PATCH: Update Application
  • POST: Move Application


  • 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


  • 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).

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.