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

# Envoy

> Follow these steps to connect Envoy via the StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges within your Envoy organization.
</Warning>

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

This guidance assumes that you are an Admin within Envoy.

## Get Your Envoy API Key

This connection will be authenticated on behalf of a private app you will create in your Envoy account.

<Steps>
  <Step title="Log in to Envoy">
    Log in to your Envoy Account and navigate to the [Dev Dashboard](https://dashboard.envoy.com) by clicking Apps > Dev Dashboard on the left.

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

  <Step title="Create a New App">
    Click the Create New button in the top right to create the new App.

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

  <Step title="Enter App Details">
    Under Create App, enter the required fields:

    <ul>
      <li>Name</li>
      <li>API Scopes: `employees.read`</li>
    </ul>

    All other fields under Details are optional. Leave the options unchecked under Where will customer install your app?
    When done, click the Save button.

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

  <Step title="Copy API Key">
    Copy the displayed Client API Key and store it safely.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="API Key" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/Rs6NeAXs5I3UVlO6/images/envoy/image4.png?fit=max&auto=format&n=Rs6NeAXs5I3UVlO6&q=85&s=042e3b9ed00a28c0ce78a3a2f1fc57b4" width="1638" height="836" data-path="images/envoy/image4.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter API Key">
    Upon reaching the Link Account page, enter your API Key from the previous step.
  </Step>

  <Step title="Connect">
    Proceed by clicking the Connect button.
  </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!

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/iam_list_users) available from the provider:

<ul>
  <li>Users</li>
</ul>

## Useful Links

<Card title="Authentication Guide" icon="link" href="https://developers.envoy.com/hub/docs/getting-an-access-and-refresh">
  [https://developers.envoy.com/hub/docs/getting-an-access-and-refresh](https://developers.envoy.com/hub/docs/getting-an-access-and-refresh)
</Card>