There are two separate API keys needed to fully implement the Teamtailor and Alva integration.
1. Get an "Integration key" from Teamtailor
This key is how Teamtailor and Alva mainly communicate with each other. Follow the steps below to retrieve the key:
Go to Teamtailor Marketplace
Go to Assessment and click the Alva Labs card
Click Activate
Copy the key and store it temporarily in a secure place
Click Finish installation to save the new "Integration key"
2. Insert the Integration key into Alva
Go to your company Settings
If you don't have access to it, either ask the admin in your company or reach out to Alvas Support TeamClick the integrations tab
Click "Add integration"
4. Choose Teamtailor by clicking "Add"
5. From here, you can add the Integration key in the designated field. You will get a success message after you have added it.
6. If you copied the key to your notes or a text document, don't forget to delete it.
We still have one more key to retrieve from Teamtailor and paste into Alva. Follow the steps ⬇️
3. Retrieve an API key from Teamtailor and paste to Alva
The second key that you need can aslo be retrieve from your Teamtailor account.
In Teamtailor, click into "Settings"
2. Scroll down the list to your left, and choose "API"
3. Select "New API Key"
- Name it Alva Labs
- Set API Scope to "Admin"
- Select "Read" & "Write"
- Click "Create"
4. Insert the Teamtailor API key in Alva
Once you've created the "Read Write admin" key, you have to enter it into Alva.
Go to your company Settings
Click the integrations tab
Click into the already added Teamtailor integration
4. Click on Add account and paste the "Read Write Admin" key into the empty field on the bottom of the pop up and click "Save changes"
5. If you copied the key to your notes or a text document, don't forget to delete it.
5. Enable Hiring Team Sync
The integration with Teamtailor supports a feature called hiring sync, which ensures that members of the hiring team with access to the job position in Teamtailor also get the relevant permissions to view candidate assessment results in Alva. You no longer need to invite the hiring managers manually to Alva, this is synced automatically as long as you have created a job in Teamtailor with the Alva trigger in it. 😊
All you have to do is toggle on the "Sync hiring team" option in Alva under the Teamtailor integration as shown below
The users that are synced are those who are listed as "Recruiter" and "Additional users" as shown below
If the relevant member of the hiring team does not already have an Alva account, they will be sent an invitation to create one via their email.
Now you are ready to start using the Teamtailor integration!
If you have any questions on the integration, set up or how to use Alva, please reach out to our Customer Support team on support@alvalabs.io or leverage the chat in the bottom right corner in the Alva platform.