> ## 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.

# 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/TvtHDboh-oxH0_vz/images/hibob/image1.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=2fd555d01469d216b3cbf213b83c73da" 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/TvtHDboh-oxH0_vz/images/hibob/image2.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=5f8e38cd6fefa27fc32fc8403bf67060" 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/TvtHDboh-oxH0_vz/images/hibob/image3.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=6df93a1e3ee4e9c726885642add40df8" 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/TvtHDboh-oxH0_vz/images/hibob/image4.png?fit=max&auto=format&n=TvtHDboh-oxH0_vz&q=85&s=3faf6e3ebab64658e3b3b15593be1503" width="939" height="1467" data-path="images/hibob/image4.png" />
    </Frame>
  </Step>
</Steps>

## 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>