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

# Cezanne HR

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

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

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

## Getting your Subdomain

<Steps>
  <Step title="Find the Subdomain">
    You can find the subdomain in the URL of your Cezanne HR account by taking the portion that appears before `.cezanneondemand.com` and after `https://`.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Subdomain Example" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/cezannehr/image6.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=0e7e6f0cb104ae73cc2910ea67e6792b" width="2878" height="1516" data-path="images/cezannehr/image6.png" />
    </Frame>
  </Step>
</Steps>

## Creating an Application

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

    In the sidebar, navigate to `Administration` → `Security Settings` → `Authorised Applications`.

    Click **Add New**.

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

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Navigate to Applications" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/cezannehr/image2.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=36504c5c0aef22b8630480ede282b57a" width="2874" height="1426" data-path="images/cezannehr/image2.png" />
    </Frame>
  </Step>

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

    Click **Ok**.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Creating Application" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/cezannehr/image3.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=6d2be071ce60bfb14fc57b8c6fcc01c6" width="2874" height="1424" data-path="images/cezannehr/image3.png" />
    </Frame>

    Check the **Enable All Users** checkbox to allow any service user to authenticate using this application. If unchecked, only users explicitly added will be able to authenticate.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enable All Users" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/cezannehr/image11.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=5f127a9cfab267db9226aa10e6df29d6" width="664" height="833" data-path="images/cezannehr/image11.png" />
    </Frame>

    In the scopes section, ensure at a minimum the following permissions are enabled:

    * **Token Details** - Required for authentication
    * **API Read Access** - Required for data retrieval

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Configure Scopes" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/cezannehr/image12.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=51755f5592457c2c1166227cca991c79" width="786" height="718" data-path="images/cezannehr/image12.png" />
    </Frame>

    In the `Allowed Callbacks` field, enter the following URL:

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

    Click **Save**.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Creating Application" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/cezannehr/image4.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=a1be2bb35e14f99e94a974db806c49fa" width="2874" height="1432" data-path="images/cezannehr/image4.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="Creating Application" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/cezannehr/image5.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=74e05f5d828e6e461074effcd7e429de" width="2870" height="1426" data-path="images/cezannehr/image5.png" />
    </Frame>
  </Step>
</Steps>

## Linking to StackOne

You can use the `Client ID`, `Client Secret`, and `Domain` to link your Cezanne HR account with StackOne.

<Steps>
  <Step title="Link Cezanne HR Account">
    In the modal, enter the `Client ID`, `Client Secret`, and `Domain` 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/YuiSn9_H_qPKyg_D/images/cezannehr/image7.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=0f2bc1a7121c8b23386bdf7c0570149c" width="974" height="1268" data-path="images/cezannehr/image7.png" />

      <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/YuiSn9_H_qPKyg_D/images/cezannehr/image8.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=a38a36b2709def38cc3c6c65101dc715" width="964" height="1262" data-path="images/cezannehr/image8.png" />
    </Frame>
  </Step>

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

    Click **Log In**.

    <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/YuiSn9_H_qPKyg_D/images/cezannehr/image9.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=f9db601f76994b2613d65d723c3450c7" width="2038" height="1594" data-path="images/cezannehr/image9.png" />
    </Frame>
  </Step>

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

    <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/YuiSn9_H_qPKyg_D/images/cezannehr/image10.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=3c62b5f01832cd742d7d421d0cb49735" width="2044" height="1594" data-path="images/cezannehr/image10.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://api.cezannehr.com/">
  [https://api.cezannehr.com/](https://api.cezannehr.com/)
</Card>
