Prerequisites

Before getting started, please carefully read the following to make sure you fulfill all requirements for the integration to work:

• Your Teamtailor's account must have the "Company Admin" role. This is necessary for creating a Teamtailor Marketplace integration.

Create an integration

1. Log in to your Teamtailor instance, and navigate to the "Settings" page in the top right corner:
   
    
2. Click on the "Integration's Hub" tab under the "Integrations" section on the bottom left side of the page:
   
    
3. Click on the "CREATE A NEW PARTNER" button:
   
    
4. Filling in information inside the "New Partner" page:
   a. Set the "Partner Base URL" field to https://api.kombo.dev/v1/partner/teamtailor.
   b. Set the "Category in marketplace" option as "Assessment".
   c. Leave the "Activation form" field inside the "Additional options" as it is.
   Fill in the rest of the fields based on your company's information, and click on "Save".
   
    
5. You should be able to see your newly created partner integration inside the "Integration's Hub" Page, and its "Status" will be shown as "Not Published":
   
   
    

Becoming a partner

After you've created an integration, please contact Teamtailor at partnerships@teamtailor.com to get your integration published. 

Set up partner credentials in Kombo

Once the partnership process has been completed and your partner integration is published in Teamtailor's Marketplace, you can enable the Teamtailor Assessment integration by entering your partnership credentials in Kombo.

Kombo requires the following credentials from your Teamtailor partner integration:

• Partner Integration ID
• API Key
• Webhook Signature
   

1. You can find your "Partner Integration ID" next to the name of your partner integration in Teamtailor:
   
    
2. Check on "Show details", and you can find your "API Key" and "Webhook Signature" from the pop-up: