Skip to main content

Import new hires from Teamtailor

This guide explains how to integrate Teamtailor with Humaans to streamline your onboarding process.

When a new candidate is hired in Teamtailor, their information will automatically sync into a new hire profile in Humaans. Any further changes to their data in Teamtailor won’t map automatically. Humaans becomes the source of truth.

Before you begin

  • The Teamtailor integration is included in the Growth plan and above. If you don't see Teamtailor under Integrations, contact us.

  • A Teamtailor administrator needs to request a webhook key for Humaans from Teamtailor support.

  • To import an employment start date or a salary, enable the Job Offers add-on in Teamtailor.

Step 1 - Activate the integration in Teamtailor

To enable the integration, first open your Teamtailor account, and follow these steps:

  1. Click your account in the top-right corner of Teamtailor to open the dropdown menu.

  2. Open Teamtailor Marketplace.

  3. Click HR System.

  4. Select Humaans.

  5. Click Activate.

  6. Map your Teamtailor custom fields to the Humaans fields listed during activation. To learn what each field does, read Map Teamtailor custom fields.

  7. You’ll be redirected to a screen displaying your webhook key. Take note of this for later steps.

  8. Click Finish installation.

Note: If you experience issues with access, contact Teamtailor's support.

Step 2 - Add the Humaans trigger to your Hired stage

  1. Click Jobs in the top navigation bar in Teamtailor.

  2. Select the job role you want to import candidates from.

  3. Click the three dots on the Hired stage.

  4. Click Triggers.

  5. Click Send Humaans candidate.

Only add the Send Humaans candidate trigger to the Hired stage of your job template in Teamtailor.

Repeat for each job role, or add the trigger to the Hired stage of your default job template to cover every role.

Step 3 - Connect Teamtailor in Humaans

  1. Click Integrations in Humaans.

  2. Click the ATS tab or scroll to find Teamtailor.

  3. Click Configure.

  4. Click Enable Teamtailor integration.

  5. In the Webhook key field, paste the webhook key from Teamtailor.

  6. Click Save.

Note: The Configuration and Logs tabs stay disabled until you save a webhook key.

Moving forward, when a new employee is hired in Teamtailor, their data will be imported to a new hire profile in Humaans. This gives you a chance to review their information before adding them as an active member to Humaans.

Step 4 - Choose which fields import

To check which data is mapping from Teamtailor and where to in Humaans, click Configuration.

Teamtailor fields sit on the left, Humaans fields on the right, and the toggle on each row controls whether that field imports. The eight rows of data points are always toggled on by default and can't be changed.

Job Offer › Salary is the only default field that needs to be toggled on.

The candidate's first Teamtailor location has to match a Humaans location (place of work) exactly, including capitalisation. Without a match, the location doesn't import and you can set it when you add the new hire as a member.

To map anything else, click Add mapping, choose a Teamtailor field to map to a Humaans field. To delete a row, click the bin icon.

Data fields that map from Teamtailor to Humaans

Below is the list of fields that are imported from Teamtailor into Humaans:

Teamtailor

Humaans

First name

First name

Last name

Last name

Email

Personal email

Phone

Personal phone

Role

Job title

Department

Department

Location

Place of work

Job Offer › Start date

Employment start date

Job Offer › Salary (off by default)

Salary

Notes on individual data fields

  • Employment start date: comes from the most recently accepted job offer. Humaans also uses this date as the effective date for the salary and job role.

  • Job title: comes from the candidate's role, or from the Teamtailor job title if the role is empty. If neither is set, the job title imports as Missing.

  • Salary: comes from the most recently accepted job offer. Humaans supports hourly, daily, weekly, monthly and annual frequencies. Any other frequency skips the salary and records a warning in the logs.

Map Teamtailor custom fields

Teamtailor offers these fields to map during activation:

Teamtailor field

Expected values

Contract type

Permanent, FTC

Employment type

Full time, Part time

Job family

Any text

Level

1, 2, 3, 4, 5, 6, 7, 8

Notice period

Any text

Salary band

A, B, C

Team

Any text

Working pattern

Any text

Weekly hours

A number

Bonus eligibility

Yes, No

Personal address

Any text

Work address

Any text

Reading the activity log

This is tracked in the logs. Each candidate that reaches the Hired stage produces an entry under Logs, with the candidate's name and one of four outcomes:

Outcome

Meaning

Imported

Every mapped field imported.

Imported with warnings

The new hire imported, but one or more fields didn't. Each warning names the field and the reason.

Skipped

The person already exists in Humaans, matched on personal email or Teamtailor candidate ID. Their existing data doesn't change.

Failed

The import didn't complete.

Step 5 - Import into a specific space

This applies if you have Spaces enabled. Without a space selected, new hires import into the default space.

  1. Click Integrations.

  2. Click the ATS tab or scroll to find Teamtailor.

  3. Click Configure.

  4. Click Configuration.

  5. Under Humaans Space, select the space to import into.

  6. Click Save.

Adding and managing multiple connections

Click Add connection in the bottom-left corner to create another connection. Each connection holds its own webhook key, target space and field mapping, so two companies in separate spaces can import different sets of data.

For example, if Company A and Company B each have a space, a new hire for Company B can import into Company B's space with its own set of mapped fields. Both companies can also import into the same space.

With two or more connections, opening the Teamtailor integration shows the list first. With one connection, Humaans opens it directly. Connections are labelled with their number and space, such as Connection 2 - Company B.

To remove a connection, open it and click Delete connection.

Add a new hire as an active member

Candidates imported from Teamtailor appear under the New hires tab in the People directory, so you can review their information before you add them as a member.

To review the new hire’s information, click Add member.

Did this answer your question?