> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-mintlify-faq-auth-1778741451.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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/hibob/image1.png?fit=max&auto=format&n=kcIsNGrNDMHtxrmj&q=85&s=3bb9a156943b8de970b93a74a4be9465" 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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/hibob/image2.png?fit=max&auto=format&n=kcIsNGrNDMHtxrmj&q=85&s=8e1678ad3d989bd58f9ab333e0bc5012" 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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/hibob/image3.png?fit=max&auto=format&n=kcIsNGrNDMHtxrmj&q=85&s=5685499cc99612d3e93c68aab3b7a113" 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-mintlify-faq-auth-1778741451/kcIsNGrNDMHtxrmj/images/hibob/image4.png?fit=max&auto=format&n=kcIsNGrNDMHtxrmj&q=85&s=4b86ddf5323a00a0ff8d13acca7ed4fc" 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>