> ## 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 15Five with API Key – StackOne Hub

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

<section data-guide-section data-guide-scopes="">
  <h2>Enable the Public API</h2>

  <p>The Public API must be enabled by an administrator in 15Five before any keys can be generated.</p>

  <Steps>
    <Step title="Sign in to 15Five">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://my.15five.com/" target="_blank" rel="noopener noreferrer">15Five account</a> as a company administrator.</p>
      </div>
    </Step>

    <Step title="Open Integrations">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click the <strong>Settings</strong> gear in the bottom-left corner, then choose <strong>Integrations</strong> from the menu.</p>
      </div>
    </Step>

    <Step title="Open Public API">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Locate <strong>Public API</strong> in the integrations list and open the Company API keys page.</p>

        <ul>
          <li>If Public API has not been enabled before, click <strong>Enable</strong>.</li>
          <li>If it is already enabled, click <strong>Manage</strong> — the button replaces <strong>Enable</strong> once an API key exists. From the Manage page you can create a new key or copy the access token of an existing key.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Create your API key</h2>

  <p>Create a new key tied to your administrator user. The key inherits your role permissions.</p>

  <Steps>
    <Step title="Click &#x22;Create new key&#x22;">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>Company API keys</strong> page, click <strong>Create new key</strong>.</p>
      </div>
    </Step>

    <Step title="Name the key and configure scope">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Give the key a short identifying name (for example <code>stackone-prod</code>) so you can recognise it later.</p>

        <ul>
          <li><strong>Important:</strong> Leave <strong>High Fives only</strong> unchecked. When checked, the key returns <code>403 You do not have permission to perform this action</code> against non-High-Fives endpoints. Only enable it if the integration is restricted to High Fives.</li>
          <li>Make sure <strong>Enabled</strong> is checked.</li>
          <li>Click <strong>Save</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy the access token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Copy the 32-character access token from the <strong>Access token</strong> column and store it securely for use later. It is sent as the raw value of the Authorization header (matching the official 15Five curl example).</p>

        <ul>
          <li>Each active key's access token remains visible on the Company API keys page, so you can re-copy it later from the same screen.</li>
          <li>If StackOne actions return permission errors for an existing key, click <strong>Edit</strong> on the key and confirm <strong>High Fives only</strong> is unchecked and <strong>Enabled</strong> is checked.</li>
          <li>The key inherits the role of the user who created it. Review-cycle endpoints will return empty results unless the creator holds both Company Admin and Review Admin roles.</li>
          <li>Keys expire one year after creation.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</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 Key</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.
