> ## 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. 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 **1. Navigate to Settings** In your Teamtailor account, click on Settings. ![Settings](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image1.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=7108c1f9d9aa5c8fbf9ce34a834f4e9e) **2. Find API Keys** On the left-hand menu under the integrations header, find API keys. ![API Keys](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image2.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=b26228346a729f34288612b19131d567) **3. Create a New API Key** Click the New API Key button at the top right of the page. ![New API Key](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image3.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=f1deb014846e71eb8e8f8eea3962ceec) **4. Set Name and Permissions** Enter a descriptive name, set the scope to `admin` and permissions, where only Read is required. ![Set Permissions](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image4.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=6f94f24544146cf3397739a4dd64b10e) **5. Copy API Key** Copy the API key to a safe place. ![Copy API Key](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image5.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=29cba359e43549ad69351b4bb8d8e859) **6. Get Company ID** Make a note of the `company ID`, which is part of the URL as shown below: ![Company ID](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image6.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=ada69752ffade7fc0407427cdc83c72b) ## Get user credentials You will also need to provide a user email and password. It is recommended that you set up a new account for integration purposes. **1. Create a New Employee** Find the employees tab and click the ➕ to create a new employee. ![New Employee](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image7.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=a7eb25081fdda18626d453877ab30161) **2. Fill Out Required Fields** Fill out the required fields and set the Role to Recruitment Admin. This will ensure the account has the correct permissions. ![Set Role](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image8.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=65d3dbc1d6c1dd9dd2255c3ab10e3e3a) **3. Add Employee** Click Add employee. ![Add Employee](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image9.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=bb0df26a7b75a0b55948077103d11980) **4. Create Account** The email address you entered will receive an invitation. Click `Create account`, you may have to log out of your current account to create the password. ![Create Account](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image10.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=ea19e28a50d81d2d9ba88efe2a7dea8d) **5. Find the Invitation Link** If you have not received an invitation, you can go to the `Employees` tab again and click on the user's `pencil` ✏️ icon to edit their profile. You will see a link to the invitation, and you can click through this to set up the account. ![Invitation Link](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image11.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=cb1c1cadcac1a723cb2955aaeeb2fc8c) **6. Get Account Email and Password** You should now have the account email address and password to proceed with the Hub. ⚠️ If your account uses SSO, you may have to create the account differently: ### Accounts with Single Sign-On (SSO) Follow steps 2.1 to 2.2 inclusive to create the employee, you will then have to exclude the employee from SSO, under the heading `Exclude individual users from SSO login`, as detailed here: **1. Exclude from SSO** After the user has been excluded, ensure a password is set. You may have to edit the permissions of the user by accessing the Employees tab and clicking on the gear ⚙️ here. ![Exclude from SSO](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image12.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=7075ae60fb07f978580c26b116d5faa2) **2. Set Role** You will see a page similar to step 2.2, where you can set the role to `Recruitment admin`. ![Set Role](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image13.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=ab188bb921317f04103d122c6c6ab384) ## Input the collected inputs into the StackOne Hub **1. Link Account** Upon reaching the Link Account page, enter the gathered details and proceed by clicking the `Connect` button. ![Link Account](https://mintcdn.com/stackone-hub/sJdRVJBL-SmQlUk2/images/teamtailor/image14.png?fit=max\&auto=format\&n=sJdRVJBL-SmQlUk2\&q=85\&s=caf54d04a44c9bfecfd2b21e06867ac9) ## Available data This integration has the following [IAM Resources](https://docs.stackone.com/reference/iam_list_users) available from the provider: ## Useful Links > **[API Reference](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) > **[Support](https://support.teamtailor.com)** > > [https://support.teamtailor.com](https://support.teamtailor.com) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.