> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Hibob - API Key Authentication

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

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

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

## Generating your Hibob API Key

<Steps>
  <Step title="Login to Hibob">
    Login to your Hibob account and click on your account avatar in the bottom left corner. Select API access from the dropdown menu.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Hibob API Access" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/hibob/image1.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=f50c08d8104b34a27055f1606a4b1021" width="2880" height="1626" data-path="images/hibob/image1.png" />
    </Frame>
  </Step>

  <Step title="Generate token">
    Click Generate token.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Generate Token" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/hibob/image2.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=c549952b318c379df7fae91312fc1bf7" width="1429" height="552" data-path="images/hibob/image2.png" />
    </Frame>
  </Step>

  <Step title="Enable Approved Scopes">
    Enable the following Approved scopes and click Save.

    * `Full employee read`
    * `Employee fields read`
    * `Payroll Info read`
    * `Timeoff submit request & read who's out`
    * `Employee update`
    * `Employee fields write`

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Approved Scopes" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/hibob/image3.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=d0ce7ee77132780c9f6690d2a14ade0f" width="1431" height="1325" data-path="images/hibob/image3.png" />
    </Frame>
  </Step>

  <Step title="Copy token">
    Click Copy token.
  </Step>
</Steps>

## Linking your account in StackOne

<Steps>
  <Step title="Enter API Key">
    Upon reaching the Link Account page, enter the generated API key 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-docs-confluence-api-token-update/gCnVSZzD28kSlWtw/images/hibob/image4.png?fit=max&auto=format&n=gCnVSZzD28kSlWtw&q=85&s=cc01394b5e2bf4cb3f8625b1829bd369" width="939" height="1467" data-path="images/hibob/image4.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Troubleshooting

If you're getting `Could not connect account. Please check your credentials and try again` error:

1. Verify you're pasting the correct API key from the Hibob interface.
2. Ensure to Save settings inside the Approved scopes section, since without permissions APIs can't communicate with each other.

## Useful Links

<Card title="API Reference" icon="link" href="https://apidocs.hibob.com/docs">
  [https://apidocs.hibob.com/docs](https://apidocs.hibob.com/docs)
</Card>