> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Oneflow with API Token – StackOne Hub

> Link a Oneflow account in the StackOne Hub using API Token. End-user guide to authorize the integration and start using Oneflow actions.

<section data-guide-section data-guide-scopes="">
  <h2>Enable the Custom Integration</h2>

  <p>Oneflow exposes API tokens through the Custom Integration, which must be enabled for your account first.</p>

  <Steps>
    <Step title="Sign in to Oneflow">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://app.oneflow.com/login" target="_blank" rel="noopener noreferrer">Oneflow account</a>.</p>

        <ul>
          <li>In the left sidebar, click <strong>Marketplace</strong>.</li>
          <li>Scroll to the <strong>Workflow</strong> section.</li>
          <li>Click <strong>Custom Integration</strong> on the right.</li>
        </ul>
      </div>
    </Step>

    <Step title="Enable the integration">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Activate the Custom Integration for your account.</p>

        <ul>
          <li>Click <strong>Enable</strong>.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Generate your Oneflow API token</h2>

  <p>Create an API token from the Custom Integration. The token is displayed only once.</p>

  <Steps>
    <Step title="Open the Custom Integration">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the left sidebar, go to <strong>Admin</strong> > <strong>Integrations</strong> and open <strong>Custom Integration</strong>.</p>

        <ul>
          <li>Click the <strong>API Tokens</strong> tab.</li>
        </ul>
      </div>
    </Step>

    <Step title="Generate a new token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Create a token for StackOne.</p>

        <ul>
          <li>Click <strong>Generate a new token</strong>.</li>
          <li>Enter a token name (required, for example <code>StackOne</code>).</li>
          <li>Click <strong>Confirm</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy the API token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Your new API token is displayed.</p>

        <ul>
          <li>Format: 40 characters (letters, digits, and hyphens).</li>
          <li>Copy the token and store it securely for use later.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Find your user email</h2>

  <p>In most cases this is simply the email address you use to sign in to Oneflow. Requests run under the permissions of this user, and the email is sent with every request to determine what the integration can read and write.</p>

  <ul>
    <li>Use the email address you sign in to Oneflow with, or any other active user in the same Oneflow account.</li>
    <li>The user must be active in the same Oneflow account.</li>
    <li>The user's permissions govern which contracts and workspaces the integration can access.</li>
  </ul>
</section>

## Linking the Account from the Hub

<Steps>
  <Step title="Navigate to the Hub">
    Use one of the three <a href="/guides/accounts-section#linking-accounts">Linking Account Methods</a> to access the Hub.
  </Step>

  <Step title="Fill out the fields">
    Fill out the following fields using details from your provider:

    <ul>
      <li><strong>API Token</strong></li>
      <li><strong>User Email</strong></li>
    </ul>
  </Step>

  <Step title="Connect">
    <ul>
      <li>Click <strong>Connect</strong></li>
      <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
      <li>Once authorization is successful, you will see a confirmation popup</li>
    </ul>
  </Step>
</Steps>

If the account linking is successful, you will see the newly linked account in your <a href="/guides/accounts-section">Accounts</a> page.