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

# Oyster HR

> Follow these steps to connect Oyster HR with StackOne Hub successfully.

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

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

## Creating a Developer Application

<Steps>
  <Step title="Navigate to Developer Applications">
    Sign in to your Oyster HR account.

    In the sidebar, navigate to `Company` → `Developer`.

    Click **Create new Developer Application**.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Navigate to Developer Applications" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/oysterhr/image1.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=dec48c4f566b17ccdaf420f693a3ef5a" width="1574" height="920" data-path="images/oysterhr/image1.png" />
    </Frame>
  </Step>

  <Step title="Creating a Developer Application">
    Enter `Name` and `Description` for the application.

    In the `Redirect URL` field, enter the following URL:

    ```
    https://api.stackone.com/connect/oauth2/oysterhr/callback
    ```

    Click **Submit**.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Creating Developer Application" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/oysterhr/image2.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=eac2f2a16a121ad28c10cb5d625ac531" width="1559" height="930" data-path="images/oysterhr/image2.png" />
    </Frame>
  </Step>

  <Step title="Note Client ID and Client Secret">
    Record the `Client ID` and `Client Secret` for use in the next steps.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Client ID and Secret" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/oysterhr/image3.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=08b64e2e08b598e36faeb77336826133" width="1733" height="918" data-path="images/oysterhr/image3.png" />
    </Frame>
  </Step>

  <Step title="Copy Authorization URL">
    Record the `Authorization URL` for use in the next steps.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Authorization URL" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/oysterhr/image4.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=8a0caab985faf22d56bd4e4c41e700eb" width="1317" height="932" data-path="images/oysterhr/image4.png" />
    </Frame>
  </Step>
</Steps>

## Linking to StackOne

You can use the `Client ID`, `Client Secret`, and `Authorization URL` to link your Oyster HR account with StackOne.

<Steps>
  <Step title="Link Oyster HR Account">
    In the modal, enter the `Client ID`, `Client Secret`, and `Authorization URL` from the previous steps.

    Click **Connect**.

    <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/kA_-fzt7TEYGckYp/images/oysterhr/image5.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=b14e50b1fa30e6ada0c5b84a3198ddff" width="436" height="695" data-path="images/oysterhr/image5.png" />
    </Frame>
  </Step>

  <Step title="Enter Login Details">
    In the Oyster HR popup modal, enter your `Email` and `Password`.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter Login Details" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/oysterhr/image6.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=e99d2ab80e2e9e691bd6c67999a50b2c" width="1019" height="852" data-path="images/oysterhr/image6.png" />
    </Frame>
  </Step>

  <Step title="Authorize Request">
    Click **Authorize**.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Authorize Request" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/oysterhr/image7.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=26703e967b52a783af7b9a93578f0185" width="1017" height="853" data-path="images/oysterhr/image7.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!

## Useful Links

<Card title="API Reference" icon="link" href="https://docs.oysterhr.com/reference/post_oauth2-token-1">
  [https://docs.oysterhr.com/reference/post\_oauth2-token-1](https://docs.oysterhr.com/reference/post_oauth2-token-1)
</Card>