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

# Zelt

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

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

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

## Generate a Zelt Client ID and Client Secret

<Steps>
  <Step title="Open Settings">
    Within Zelt, click on Settings in the lower left corner.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Settings" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/zelt/image1.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=5ac84b2f72a3aa843eaed947828717b9" width="1387" height="902" data-path="images/zelt/image1.png" />
    </Frame>
  </Step>

  <Step title="Navigate to Security">
    Under Settings > Organisation, click Security.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Security" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/zelt/image2.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=b1014bf053796e095968d60aa4f309ca" width="1037" height="904" data-path="images/zelt/image2.png" />
    </Frame>
  </Step>

  <Step title="Generate Credentials">
    Next to Developer hub, click the Generate button.
  </Step>

  <Step title="Enter Details">
    In the view that appears, enter the following:

    <ul>
      <li>Name: e.g. "StackOne Service Credentials"</li>
      <li>Description: e.g. "Service authorization for StackOne integration"</li>
      <li>Redirection URI: `https://api.stackone.com/connect/oauth2/zelt/callback`</li>
    </ul>

    Press the Generate button at the bottom of the view.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Generate Credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/zelt/image3.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=aed0a5b4e0c03b818538b0bacb608bc2" width="562" height="889" data-path="images/zelt/image3.png" />
    </Frame>
  </Step>

  <Step title="Copy Authorization Credentials">
    A window will appear with the authorization credentials. Copy each of the generated values, and store them in a safe place:

    <ul>
      <li>App ID</li>
      <li>Client ID</li>
      <li>Client Secret</li>
    </ul>

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Authorization Credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/zelt/image4.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=6ad85dfbdb6c4da44f398f35988ff137" width="681" height="269" data-path="images/zelt/image4.png" />
    </Frame>
  </Step>

  <Step title="Update App Permissions">
    Select the App that was created in the previous step. Then on the left navigation menu, select the `Permissions` tab. Click the pencil icon to edit the permissions.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Edit Permissions" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/zelt/image7.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=8275615f9d38a0c356e83fc4438a794c" width="1860" height="676" data-path="images/zelt/image7.png" />
    </Frame>
  </Step>

  <Step title="Update App Permissions">
    Ensure the following permissions are selected, provide a reason for each permission, then click the **Update scopes**.

    <ul>
      <li>user:read:all</li>
      <li>user.basicInfo:read</li>
      <li>user.personalInfo:all</li>
      <li>user.personalInfo:read</li>
      <li>user.contract:read:all</li>
      <li>user.compensation:read:all</li>
      <li>user.role:read:all</li>
      <li>company.settings:read</li>
      <li>documents:all</li>
      <li>user.basicInfo:all</li>
      <li>user.onboard:all</li>
      <li>user.contract:all</li>
      <li>user.compensation:all</li>
      <li>user.role:all</li>
    </ul>

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Select Permissions" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/zelt/image8.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=1aeb4e372304c1d5f0646e126e244724" width="2292" height="1466" data-path="images/zelt/image8.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter Credentials">
    Upon reaching the Link Account page, enter the Client ID and Client Secret generated in the previous step.
  </Step>

  <Step title="Connect">
    Proceed by clicking the `Connect` button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Connect Button" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/w__eN0U5iLwN8ehP/images/zelt/image5.png?fit=max&auto=format&n=w__eN0U5iLwN8ehP&q=85&s=8c2a634ef442785319cf3ee34a70ed0d" width="483" height="468" data-path="images/zelt/image5.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!