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

# CascadeHR

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

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

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

## Get your Client Key and Client Secret

> **Important:**
> IRIS Cascade does **not** offer a self-service option for creating API credentials.\
> To receive your **Client Key** and **Client Secret**, you must submit a request to IRIS support.

Refer to the official IRIS documentation for detailed instructions:\
[Requesting access to the HR API](https://help-iris.co.uk/hr/cascade/api/getstart/request-access-api.htm#Availabl)

## Connecting to StackOne

<Steps>
  <Step title="Enter your API credentials">
    Upon reaching the Link Account page, enter the following credentials received from IRIS CascadeHR Support:

    * Client ID (Key)
    * Client Secret
  </Step>

  <Step title="Enter additional connection informations">
    * **Location Hierarchy Level** (optional): required to fetch locations
    * **Department Hierarchy Level** (optional): required to fetch departments and create employees
    * **Team Hierarchy Level** (optional): required to fetch teams and create employees

    After entering the information above, proceed by clicking the **Connect** button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter your API credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/YuiSn9_H_qPKyg_D/images/cascadehr/image1.png?fit=max&auto=format&n=YuiSn9_H_qPKyg_D&q=85&s=83847b37c48ba2af112f31a04b1275dc" width="978" height="1328" data-path="images/cascadehr/image1.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="Requesting access to the HR API" icon="link" href="https://help-iris.co.uk/hr/cascade/api/getstart/request-access-api.htm#Availabl">
  Official guide to request CascadeHR API credentials
</Card>

<Card title="CascadeHR API Reference" icon="link" href="https://swagger.hrapi.co.uk/">
  Live Swagger documentation for CascadeHR endpoints
</Card>