> ## Documentation Index
> Fetch the complete documentation index at: https://hub.stackone.com/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.

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

**1. Open Settings**

Within Zelt, click on Settings in the lower left corner.

![Settings](https://mintcdn.com/stackone-hub/HYJwyqbEuT1SMQL-/images/zelt/image1.png?fit=max\&auto=format\&n=HYJwyqbEuT1SMQL-\&q=85\&s=2951bdff295d2b1048ad20ea0af69451)

**2. Navigate to Security**

Under Settings > Organisation, click Security.

![Security](https://mintcdn.com/stackone-hub/HYJwyqbEuT1SMQL-/images/zelt/image2.png?fit=max\&auto=format\&n=HYJwyqbEuT1SMQL-\&q=85\&s=f225e5b5b0720abcebdb5d9cf77f187c)

**3. Generate Credentials**

Next to Developer hub, click the Generate button.

**4. 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.

![Generate Credentials](https://mintcdn.com/stackone-hub/HYJwyqbEuT1SMQL-/images/zelt/image3.png?fit=max\&auto=format\&n=HYJwyqbEuT1SMQL-\&q=85\&s=0c1a2b0e210a64b2a865166d39d1ecec)

**5. 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>

![Authorization Credentials](https://mintcdn.com/stackone-hub/HYJwyqbEuT1SMQL-/images/zelt/image4.png?fit=max\&auto=format\&n=HYJwyqbEuT1SMQL-\&q=85\&s=9ad41414e7bcbf8b7db2bbfa9aa51047)

**6. 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.

![Edit Permissions](https://mintcdn.com/stackone-hub/HYJwyqbEuT1SMQL-/images/zelt/image7.png?fit=max\&auto=format\&n=HYJwyqbEuT1SMQL-\&q=85\&s=87079e22ccdc72f20da729f787e6b737)

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

![Select Permissions](https://mintcdn.com/stackone-hub/HYJwyqbEuT1SMQL-/images/zelt/image8.png?fit=max\&auto=format\&n=HYJwyqbEuT1SMQL-\&q=85\&s=790b53d2601c29fa3e6f8387e9c4ee52)

## Connecting with StackOne

**1. Enter Credentials**

Upon reaching the Link Account page, enter the Client ID and Client Secret generated in the previous step.

**2. Connect**

Proceed by clicking the `Connect` button.

![Connect Button](https://mintcdn.com/stackone-hub/HYJwyqbEuT1SMQL-/images/zelt/image5.png?fit=max\&auto=format\&n=HYJwyqbEuT1SMQL-\&q=85\&s=15c17fa8051bb8a6d2692bd527a0b171)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.