> ## Documentation Index
> Fetch the complete documentation index at: https://hub.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Teamtailor

> Follow these steps to connect Teamtailor with StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges for your Teamtailor account.
</Warning>

If you've been directed to StackOne to integrate with Teamtailor, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Generating API key and getting Company ID

<Steps>
  <Step title="Navigate to Settings">
    In your Teamtailor account, click on Settings.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Settings" src="https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image1.png?fit=max&auto=format&n=sJdRVJBL-SmQlUk2&q=85&s=7108c1f9d9aa5c8fbf9ce34a834f4e9e" width="2880" height="796" data-path="images/teamtailor/image1.png" />
    </Frame>
  </Step>

  <Step title="Find API Keys">
    On the left-hand menu under the integrations header, find API keys.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API Keys" src="https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image2.png?fit=max&auto=format&n=sJdRVJBL-SmQlUk2&q=85&s=b26228346a729f34288612b19131d567" width="254" height="231" data-path="images/teamtailor/image2.png" />
    </Frame>
  </Step>

  <Step title="Create a New API Key">
    Click the New API Key button at the top right of the page.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="New API Key" src="https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image3.png?fit=max&auto=format&n=sJdRVJBL-SmQlUk2&q=85&s=f1deb014846e71eb8e8f8eea3962ceec" width="864" height="138" data-path="images/teamtailor/image3.png" />
    </Frame>
  </Step>

  <Step title="Set Name and Permissions">
    Enter a descriptive name, set the scope to `admin` and check both `read` and `write` permissions.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Set Permissions" src="https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image4.png?fit=max&auto=format&n=sJdRVJBL-SmQlUk2&q=85&s=6f94f24544146cf3397739a4dd64b10e" width="1012" height="872" data-path="images/teamtailor/image4.png" />
    </Frame>
  </Step>

  <Step title="Copy API Key">
    Copy the API key to a safe place.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy API Key" src="https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image5.png?fit=max&auto=format&n=sJdRVJBL-SmQlUk2&q=85&s=29cba359e43549ad69351b4bb8d8e859" width="859" height="208" data-path="images/teamtailor/image5.png" />
    </Frame>
  </Step>

  <Step title="Get Company ID">
    Make a note of the `company ID`, which is part of the URL as shown below:

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Company ID" src="https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image6.png?fit=max&auto=format&n=sJdRVJBL-SmQlUk2&q=85&s=ada69752ffade7fc0407427cdc83c72b" width="622" height="129" data-path="images/teamtailor/image6.png" />
    </Frame>
  </Step>
</Steps>

## Input the collected inputs into the StackOne Hub

<Steps>
  <Step title="Link Account">
    Upon reaching the Link Account page, enter the gathered details and proceed by clicking the `Connect` button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image15.png?fit=max&auto=format&n=sJdRVJBL-SmQlUk2&q=85&s=b1596c37ef8317776d13fad97f0a2a96" width="485" height="748" data-path="images/teamtailor/image15.png" />
    </Frame>
  </Step>
</Steps>

## Useful Links

<Card title="API Reference" icon="link" href="https://support.teamtailor.com/en/articles/5963369-use-our-teamtailor-api">
  [https://support.teamtailor.com/en/articles/5963369-use-our-teamtailor-api](https://support.teamtailor.com/en/articles/5963369-use-our-teamtailor-api)
</Card>