Skip to main content
Teamtailor ATS integration

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

Mio Mattsson avatar
Written by Mio Mattsson
Updated over a week ago

This article will cover how to set up the integration with the ATS system Teamtailor as well as how to import the new recruits to Alexis.

Table of contents

Requirements

  • Active Teamtailor account and a created API key for Teamtailor.

  • An owner in Alexis activating the integration.

Configuration

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

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

  • 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 and head over to Settings Integrations in Alexis.

  • Select Integrate with ATS and select Teamtailor and then click next.

  • Paste the API key from Teamtailor in the correct section (as seen below) and click Save.

Importing new employees from Teamtailor

Now that the setups are completed, the next step here is to learn how to import the new employees from your 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 is 2 ways to navigate to the Teamtailor import after the integration is activated. Botj ways takes you to the same view.

  • People → Export/Import → Teamtailor → Import

  • People → Employees → Teamtailor (button)

Teamtailor view

In this view you are presented with 3 tabs

  • New - Employees that has the status "Hired" in Teamtailor but has not been imported into Alexis HR.

  • Imported - Employees that has the status "Hired" in Teamtailor and have been imported.

  • All - Both of the above.

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

Integration data fields

The following data is integrated from Teamtailor into Alexis HR

  • Email

  • First name

  • Last name

  • Phone

  • Employee title

  • avatarUrl

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?