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

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

<section data-guide-section data-guide-scopes="">
  <h2>Generate an Iterable Server-Side API Key</h2>

  <p>Iterable uses API keys to authenticate requests. For a connector integration you need a "Server-side" API key with read/write access to the project's API endpoints.</p>

  <Steps>
    <Step title="Sign in to Iterable">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Open your Iterable workspace at <a href="https://app.iterable.com" target="_blank" rel="noopener noreferrer">app.iterable.com</a> (US) or <a href="https://app.eu.iterable.com" target="_blank" rel="noopener noreferrer">app.eu.iterable.com</a> (EU) and sign in.</p>
      </div>
    </Step>

    <Step title="Open the API Keys page">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Iterable's API keys live under the Integrations section of the left sidebar.</p>

        <ul>
          <li>In the left sidebar, click <strong>Integrations</strong> to expand the section.</li>
          <li>Click <strong>API Keys</strong> under Integrations.</li>
        </ul>
      </div>
    </Step>

    <Step title="Create a Server-Side API Key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Generate a new key with the correct permissions.</p>

        <ul>
          <li>Click <strong>+ New API key</strong> in the top right of the API Keys page.</li>
          <li>Give the key a descriptive <strong>Name</strong> (e.g. "StackOne Integration").</li>
          <li>Open the <strong>Type</strong> dropdown and choose <strong>Server-side</strong> (under the SERVER-SIDE heading) — this grants read/write access to all server-side API endpoints.</li>
          <li>Click <strong>Create API key</strong>.</li>
          <li>In the "Copy your new API key" dialog, click the copy button next to the key value and store it securely. After you close this dialog, Iterable will only show the key's last 8 characters — if you lose the full value you must create a new key.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Identify Your Iterable Region</h2>

  <p>Iterable runs two regional data centers. Each project is bound to one DC at creation time. Pick the region that matches your project's URL.</p>

  <Steps>
    <Step title="Determine Region from Workspace URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The workspace URL identifies your data center.</p>

        <ul>
          <li>If your workspace URL begins with `app.iterable.com` choose <strong>United States</strong>.</li>
          <li>If your workspace URL begins with `app.eu.iterable.com` choose <strong>European Union</strong>.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<div data-whitelabel-hide>
  <h2>Linking the Account from the Hub</h2>

  <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>
        <li><strong>Region</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>

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