# Teamtailor

The Teamtailor integration allows you to keep your recruiting workflow in one place. Jobs created in Teamtailor are automatically synced to JOIN and published across job boards. Applications collected through JOIN are then sent straight back into Teamtailor—so your team can focus on hiring while JOIN handles the distribution.

{% hint style="warning" %}
Before you begin, make sure to review the [External HR tools](https://help.join.com/integrations/external-hr-tools) article to understand the general requirements and limitations that apply to all integrations (e.g. sync frequency, job limits, multi-language/locations, screening questions).
{% endhint %}

Once connected, the Teamtailor integration allows you to:

* Sync jobs from Teamtailor to JOIN for multiposting
* Receive candidate applications from JOIN directly in Teamtailor
* Manage all job and applicant data directly in Teamtailor

***

### Connect Teamtailor and JOIN

{% stepper %}
{% step %}

#### Generate an API key

* Log in to your Teamtailor account
* In the top-right corner, click your profile name and select `Settings`
* In the left-hand menu, go to `Integrations` → `API keys`
* Click the pink `+ New API Key` button
* In the popup:
  * Name your key (e.g. “JOIN”)
  * Set API Scope to Admin
  * Tick both `Read` and `Write` permissions
* Click `Create`
* Copy the newly generated `API key`
  {% endstep %}

{% step %}

#### Enter your API key in JOIN

1. In JOIN, go to `Settings` → `Integrations` → `Teamtailor`
2. Paste your copied API key into the field
3. Click `Request` in the top-right corner

<figure><img src="https://1825767176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEdFjOFlkC1DEfDv3nGRh%2Fuploads%2FCHl9dYpSPQYXqAWhIZjR%2Fteamtailor-connect.png?alt=media&#x26;token=38a0fb69-d437-4cd4-95c6-4f2898fbd6af" alt=""><figcaption></figcaption></figure>

Our team will activate the integration within 1 business day. You’ll receive a confirmation email once the setup is complete.
{% endstep %}
{% endstepper %}

***

### FAQs

<details>

<summary>How often does JOIN sync with Teamtailor?</summary>

Jobs sync every 30–60 minutes. Candidate applications are delivered to Teamtailor in real time.

</details>

<details>

<summary>Where should I manage my job postings?</summary>

All job management should be done in Teamtailor. Avoid editing or archiving jobs directly in JOIN.

</details>

<details>

<summary>Can I filter which Teamtailor jobs sync to JOIN?</summary>

No. JOIN currently syncs all active jobs within your job limit from Teamtailor. Filtering is not supported. Jobs successfully synced are marked with a green checkmark <i class="fa-circle-check">:circle-check:</i> and labeled `Synced` in within JOIN.&#x20;

</details>

<details>

<summary>Are screening questions supported in this integration?</summary>

No. Screening and knock-out questions are not supported. Candidates will be forwarded without this data.&#x20;

</details>

<details>

<summary>What happens if I archive a synced job in JOIN?</summary>

The job will stop syncing. To avoid this, only archive jobs within Teamtailor.

</details>