Getting started

Before connecting with Teamtailor, we suggest reviewing the supported functionality and prerequisites below.

Supported functionality

Prerequisites

• Authentication is done per-user, so each user who is going to utilize the integration must authenticate between Spark Hire Meet and Teamtailor.
• Question sets must be created on Spark Hire Meet.
• Jobs must be created on Teamtailor.

Integration setup

If you’re an Admin or Standard user on your organization's Spark Hire Meet account, follow these steps to connect the integration.

1. Log in to Spark Hire Meet and go to Settings > Integrations.
2. Find Teamtailor in the list and click Activate integration. 
3. This will generate your API key and will be considered the Organization API key. Other users on the account will need to follow these same steps in generating their API keys, though these will be considered User API keys.
4. In Teamtailor, go to the Marketplace.
5. Under Partners, select Video interviews and choose Spark Hire.
6. Click Activate in the lower-left corner of the screen.

7. A prompt will appear where you’ll enter the API keys from Spark Hire.

   

8. API keys must be entered in a specific format in Teamtailor. Each entry goes on its own line:

   Organization: ##api key## {ENTER}
   1st Recruiter First & Last Name: ##api key## {ENTER}
   2nd Recruiter First & Last Name: ##api key## {ENTER}
   

   For example:

   Organization: 123456789123456789123456789
   John Doe: 123456789123456789123456789
   Henry Hill: 987654321987654321987564231
   

9. Repeat the same structure for all additional users. After entering all keys, click Validate credentials.

Working with Teamtailor

Send interviews individually

1. Open the candidate’s card in Teamtailor and click the ⋮ (more options) icon at the top of the page.
2. Click Add integrations and select Spark Hire – Create Interview.
3. Select the recruiter creating the interview and the interview type (One-Way or Live).
4. On the form, set:
   • The job the interview is for
   • The time zone for the interview invitation email
   • The question set (for One-Way interviews)
   • The interview deadline (One-Way) or scheduled time (Live)
5. Click Create Interview to send the invitation email to the candidate.

Send interviews using a trigger

1. Open the job where you want to use the trigger.
2. Click the Triggers icon (magic wand) on the right side of the page.
3. In the stage where you want interviews to be created, click + Add trigger.
4. Select Create Spark Hire Interview.
5. Choose:
   • The recruiter for interviews created by this trigger
   • The interview type (One-Way or Live)
6. On the form, set:
   • The job the interview is for
   • The time zone for the invitation email
   • The question set (for One-Way interviews)
   • The interview deadline or scheduled time
7. (Optional) Under Move candidate when complete, choose a stage to move candidates to after they complete the interview.
8. (Optional) Under Additional options, set a delay for the trigger.
9. Click Add trigger to save.

Watch completed interviews

To view completed interviews from the candidate card in Teamtailor, choose one of the following:

• Watch interview – Opens the interview in Spark Hire (login required).
• Share Link – Opens the interview without requiring a Spark Hire login, suitable for sharing with people who don’t have access to Spark Hire.