Skip to main content
Teamtailor integration

How to set up an integration with Teamtailor and import new hires to AlexisHR

Daniel Tollefsen avatar
Written by Daniel Tollefsen
Updated over 3 weeks ago

Note: this needs to be done by an admin user in Teamtailor

Set up the integration

Before you can import the new hires to AlexisHR you need to configure the integration with the use of a Teamtailor API Key.

  • Sign in to your Teamtailor account and go to Settings Integrations API (check their Helpdesk here if you are unsure how to retrieve an API key)

  • Create an Admin API key with a read permission and name of your choice

  • Copy your API key

  • Settings Integrations in Alexis

  • In the "Integrate with ATS system" section, click Add integration

  • Select Teamtailor and click Next

  • Paste the API key from Teamtailor in the correct section

  • Select whether you want the default import status to be "Candidates" or "New hires"

    • People are importable once their status changes to "Hired" in Teamtailor so we recommend that you select "New hire"

  • Click Save

Importing employees from Teamtailor

Now that the setup is complete, the next step is to import the new employees from Teamtailor to Alexis.

"Hired" column in Teamtailor

When you have moved a candidate to your "Hired"-column in Teamtailor, those candidates are then available to be imported to Alexis.

People → Export/Import or Employees → Teamtailor

There are 2 ways to navigate to the Teamtailor import after the integration is configured. Both methods take you to the same page.

  • People → Export/Import → Teamtailor → Import

  • People → Employees → Teamtailor (button)

Teamtailor import page

On this page you are presented with 3 tabs:

  • New: candidates that have the status "Hired" in Teamtailor, but have not been imported

  • Imported: candidates that have the status "Hired" in Teamtailor and have already been imported

  • All: includes all candidates that exist in Teamtailor

Done! Next step is to use our resume onboarding-feature to then invite them to AlexisHR.

Data fields

Teamtailor fields

Alexis fields

Mapping conditions (if any)

(Teamtailor → Alexis)

Work Section

Email

Personal - Private email

First name

Personal - First name

Last name

Personal - Last name

Phone

Personal - private phone

Employee title

Work - Title

If the title from Teamtailor does not exist in Alexis HR the title will be created as a "job title" and will be assigned to the new hire. Job titles ara managed from People - Job titles

Avatar URL

Employee avatar image

Did this answer your question?