# Teamtailor

### Overview

Integrating Teamtailor with Introist allows you to sync recruitment data for seamless HR automation. Follow these steps to connect Teamtailor to Introist.

### Prerequisites

* A **Teamtailor API Key** with the following settings:
  * **Permissions:** Admin
  * **Types:** Read
* Your **Teamtailor region** (EU or US West)

Refer to Teamtailor's guide on obtaining API credentials: [Teamtailor API Guide](https://support.teamtailor.com/en/articles/5963369-use-our-teamtailor-api)

### Connecting Teamtailor to Introist

1. In Introist, navigate to **Data → Data Sources**.
2. Click **Connect Data Source**.
3. Select **Teamtailor** from the list.
4. Enter your **API Key**.
5. Choose your **Region** (EU or US West).
6. Click **Connect**.

Your Teamtailor account is now connected to Introist.

### Setting up webhooks

If you want to start Introist automations as soon as a candidate is marked hired in Teamtailor, you can set up Teamtailor webhooks using the following steps.

1. Activate Introist in Teamtailor marketplace
   1. **Important**: Use the same API key that you used to connect Teamtailor to Introist!
2. Add Introist as a trigger to the jobs for which you would like to activate webhooks
   1. See [Teamtailor triggers](https://support.teamtailor.com/en/articles/1475768-triggers) for more guidance on how to configure triggers
3. Create [Introist Triggers](https://docs.introist.com/knowledge-base/build/triggers) to configure the details of which workflow to start and to apply some further filtering


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.introist.com/knowledge-base/build/data-sources/teamtailor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.