Teamtailor Partner API

• Partner’s Name - Enter the name of the integration partner.
• Partner Base URL - Enter the endpoint URL provided by StackOne that will be used to fetch the input field configurations with the list of packages and to send candidate test notifications.

https://api.stackone.com/external-trigger/teamtailor

• Category in marketplace - The integration will be categorised and displayed under the chosen category, such as Assessments or Background Checks, on Teamtailor’s Marketplace.
• Additional options (Activation Form) - Enter the following JSON into the activation form field:

{
   "config":{
      "fields":[
         {
            "type":"infobox",
            "content":"<a href='https://hub.stackone.com/integration-configuration-concepts/ats/teamtailor-assessment-or-background-check'>Click</a> here to learn how to use this integration",
            "icon":"info"
         },
         {
            "id":"externalTriggerToken",
            "type":"password",
            "label":"External Trigger Token",
            "required":true,
            "description":"The token to be used to trigger the workflow externally"
         }
      ]
   }
}

• Authentication Type: Select either Public + Partner API or Partner API to integrate with Teamtailor (for Assessment/Background Check integration).

• Partner Category: Select the category that corresponds to your integration on Teamtailor’s Marketplace page. For instance, if your integration is listed under the Assessments category, please select Assessment from the dropdown menu.
• Package’s List Endpoint URL - Implement and provide an endpoint to StackOne that StackOne will use to retrieve the list of packages when the recruiter wants to send a test to a candidate.

curl --location 'https://your-domain.com/<route-to-the-post-endpoint>' \
--header 'Content-Type: application/json' \
--header 'x-stackone-signature: string' \
--header 'Authorization: Basic <base64-encoded-api-key>' \
--data '{
    "job_id": "49201091",
    "account_id": "456551489512493412",
    "provider": "teamtailor"
}'

• List Assessments Packages
• List Background Check Packages

https://your-domain.com/<route-to-the-post-endpoint>

• Partner Integration ID: You can find the Integration ID next to the Integration Name under Settings > Integrations Hub in Teamtailor.
• Partner Integration API Key: The API key can be found in the Integration details under Settings > Integrations Hub in Teamtailor.

• Package ID - If you do not have the Package’s List Endpoint URL, you can specify a particular package ID that will be visible to the recruiter when they wish to send the test to the candidate.

How is the Package's List Endpoint URL different from a Static Package ID?

The Package's List Endpoint URL allows StackOne to fetch a list of available packages from your system, while the Static Package ID is fixed and available for users to select on the provider's side.

When you have a Package's List Endpoint URL
A list of packages will be available to select in Teamtailor.

When you have a Static Package ID
A static package ID will be available to select in Teamtailor.

• Name: Enter your webhook with a recognisable name.
• URL: Enter the URL where the webhook will send the notification of the enable events.

• Assessment Update Result
• Background Check Update Result

• Connector Meta Information with the provider key teamtailor for model assessments/results.update or background_checks/results.update

​

User sees the updated results with different conditions of the assessment/background check in Teamtailor

When the result status completed without any other details
When the result status failed without any other details
When the result completed with all data except Score
When the result failed with all data except Score
When the result completed with all details
When the result failed with all details
When the result not included Result URL
When the result not included Attachments URL
When the result included multiple Attachments URL