This guide walks you through how to connect your Teamtailor account to Journeys for recruiting and HR automation.
1. Creating an API key in Teamtailor
To integrate Teamtailor with Journeys, you first need to create an API key which you can do on your profile in Teamtailor.
💡 Note: Make sure the Teamtailor user who creates the API key is an admin.
Log in and click on the dropdown bar next to the user icon at the top right on the navigation bar.
Click “Settings”.
Now scroll down the left sidebar until you find a section called “Integrations”
When you find the “Integrations” section, click on “API keys”
Now press the pink button that says “New API Key”
You can give the key a name you prefer but it’s recommended to name it something relevant to the connection you want to set up. For the “API Scope” choose “Admin” and give it permission to “Read” and “Write” by clicking the empty boxes until you can see a checkmark within them.
After that you press the button that says “Create”
You should now be directed to the interface that shows you your new API key. Copy the text under “Api Key” and let’s get started on the authentication within Journeys.
2. Set up authentication in Journeys
To set up an authentication within Journeys, click “Settings” in the left navigation bar and then click “Integrations”. Find Teamtailor within the integrations and click on it.
Note: If you do not have the Teamtailor template in your integrations please contact 50skills 💬
Press the blue button that says “Authenticate”
Make sure to choose “Authorization header” in the dropdown menu for the
“Authentication type”. Put “Token” within the “Prefix” window and paste your Api Key,
that you just copied from Teamtailor, in the “Token” window.
Now toggle the “Advanced settings”
Set up your authentication like this (text to copy below):
Authentication type: Authorization header
Prefix (optional): Token
Token: The key that was generated through your Teamtailor account (Api key)
Extra headers (optional):
{
"X-Api-Version": "20240404",
"Content-Type": "application/vnd.api+json"
}
Now you have completed setting up authentication for Teamtailor! 🚀
For more information on how to set up your own API endpoints, Teamtailor has a
documentation which you can find through this link: https://docs.teamtailor.com