Skip to main content
Access: Hub plan. Only administrators and billing admins of the organization can set up the connection.
Hirify integrates with Teamtailor through an API key you create in your workspace. The integration imports your jobs, candidates, and applications with their stage history. It publishes the interview notes to the candidate’s Activity and can add the Hirify card to their profile.

​
Connect Teamtailor

You need administrator access to Teamtailor to create the key.
1

Open the connection wizard

In Settings, Integrations, ATS section, click Connect next to Teamtailor. The wizard opens on the Prepare step.
2

Create an API key in Teamtailor

The Open Teamtailor button leads to the API keys of your workspace, under Settings > Integrations > API keys. Create a key with the Admin scope and the Read / Write permission, then copy it. A read-only key is refused.
3

Paste the key

Click I have my API key, paste the key into the API key field, and click Connect.
If the key doesn’t carry every required permission, the wizard shows Insufficient permissions and lists the missing ones. Fix the key in Teamtailor and try again. To switch keys later, use Change key on the Teamtailor card. The first import is described in Connect your ATS.

​
Set up the webhook

Without the webhook, Teamtailor syncs once a day. The webhook makes it real time. You only set it up once.
1

Create the webhook in Teamtailor

On the connected Teamtailor card, the Webhook setup in Teamtailor block is marked To set up. The Open Webhook settings button leads to Teamtailor. Create a new webhook with the URL shown in the block and the Candidates, Applications, and Jobs resources.
2

Paste the signing key

Once the webhook is created, Teamtailor shows its signing key. Paste it into the Signing key field of the block and save.
The badge switches to Setup detected as soon as the first events arrive. Until the key is saved, the events Teamtailor sends are rejected.

​
Permissions

The API key gives Hirify full access to your Teamtailor data. It’s encrypted, only used for your organization, and can be revoked from Teamtailor at any time.
The key needs the Admin scope and the Read / Write permission. Hirify checks this access when you connect:

​
What the integration does

  • Import: jobs, candidates, applications with their stage history, resumes, and attached documents.
  • Sync: real time with the webhook, once a day without it.
  • Sharing the analysis: the interview notes go as a note in the candidate’s Activity, signed with your name. A graded review can come with it. See Share the analysis.
  • Automations: automatic tags, filling in custom fields, and automatic publishing of the interview notes. See ATS automations.
  • Talent pool: imported candidates feed Assistant, Sourcing, Analytics, and Data reliability.
Teamtailor doesn’t expose interview scheduling. The meeting assistant therefore isn’t scheduled from Teamtailor. Use your calendar or a meeting link instead. See Choose how to record.

​
Add the Hirify card

The Hirify card is optional. It shows a fit grade, the interview’s key takeaways, and a link to the full interview notes on the candidate profile. A Hirify trigger set on a job stage also sends the candidate and their resume to Hirify.
1

Get the activation code

On the Teamtailor card, click Get the activation code. The window shows your Connection code, valid for 24 hours.
2

Have the Hirify integration added

A company admin of your Teamtailor account asks your Teamtailor contact to add the Hirify integration.
3

Activate Hirify in Teamtailor

In the Teamtailor marketplace, select Hirify, start the activation, and paste the connection code.
Once the installation is confirmed, the Teamtailor card in Hirify shows Hirify card installed in Teamtailor. How the card works and the data it exchanges are detailed in Hirify for Teamtailor. The card also works without an Admin key. In that case, only candidates sent by the trigger are visible in Hirify, and sharing the analysis only updates the card.

​
Troubleshooting

  • Read-only key: create the key again with the Read / Write permission and try again.
  • Insufficient permissions: the key doesn’t have the Admin scope. Create it again with the Admin scope and the Read / Write permission.
  • The badge stays on To set up: check that the signing key is saved in the webhook block and that the three resources are checked in Teamtailor.
  • A change doesn’t arrive right away: adding a tag alone doesn’t trigger any event in Teamtailor. It arrives with the daily sync.
  • Sync stopped: the card shows the message returned by Teamtailor. See My ATS isn’t syncing anymore.
If the problem persists, contact support with the interview concerned and the Teamtailor IDs of the candidate and the job.

​
Disconnect Teamtailor

In Settings, Integrations, click Disconnect on the Teamtailor card. By default, data already synced is kept. Check the box in the confirmation window to delete it as well. If the Hirify card is installed, uninstall it from Teamtailor too: a trigger won’t reactivate the connection. See Disconnect a tool. To cut access on the Teamtailor side, revoke the API key under Settings > Integrations > API keys.

​
Good to know

  • An organization connects one ATS at a time.
  • The first import brings in twenty-four months of history. An older candidate enters Hirify the day they’re updated in Teamtailor.
  • When the webhook is set up, a candidate deleted in Teamtailor is also deleted from Hirify.