Skip to main content

How to Activate Alva Integration with Teamtailor

Learn how to activate the Teamtailor integration by exchanging the two API keys Alva and Teamtailor need.

Written by Pernilla Ahl

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:

  1. Go to the Teamtailor Marketplace

  2. Go to Assessment and click the Alva Labs card

  3. Click Activate

  4. Copy the key and store it temporarily in a secure place

  5. Click Finish installation to save the new Integration key


2. Insert the Integration key into Alva

  1. Go to your company Settings
    ​If you don't have access to it, either ask the admin in your company or reach out to Alva's Support Team

  2. Click Integrations

3. Click Add integration

4. Choose Teamtailor and click Add

5. From here, you can add the Integration key in the designated field.

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 it into Alva

The second key can also be retrieved from your Teamtailor account.

  1. 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.

  1. Go back to Alva and insert the Teamtailor API key

2. Once both keys are added, click Add integration

3. 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 team 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 Sync hiring team 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.


Any Questions?

Use the chat in the bottom right corner to connect with a member of our support team.

Did this answer your question?