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

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

<Warning>Organization admin access is required to create API keys with the necessary scopes.</Warning>

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

  <p>To connect Logfire with StackOne, you need to generate an API key from your organization settings in the Logfire console.</p>

  <Steps>
    <Step title="Sign in to Logfire">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your Logfire console for your region.</p>

        <ul>
          <li><strong>EU Region</strong>: <a href="https://logfire-eu.pydantic.dev" target="_blank" rel="noopener noreferrer">logfire-eu.pydantic.dev</a></li>
          <li><strong>US Region</strong>: <a href="https://logfire-us.pydantic.dev" target="_blank" rel="noopener noreferrer">logfire-us.pydantic.dev</a></li>
        </ul>
      </div>
    </Step>

    <Step title="Navigate to Organization API Keys">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click your <strong>organization name</strong> in the bottom-left corner of the sidebar, then select <strong>Org settings</strong>. In the left sidebar under your organization section, click <strong>API keys</strong>.</p>
      </div>
    </Step>

    <Step title="Create a New API Key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>+ New API key</strong> in the top-right corner.</p>

        <ul>
          <li>Enter a <strong>name</strong> and optional <strong>description</strong> for the key.</li>
          <li>Select the following <strong>Organization Scopes</strong>: `organization:create_project`, `organization:read_channel`, `organization:write_channel`.</li>
          <li>Select all <strong>Project Scopes</strong>: `project:read`, `project:write`, `project:write_token`, `project:read_token`, `project:read_dashboard`, `project:write_dashboard`, `project:read_alert`, `project:write_alert`, `project:read_variables`, `project:write_variables`.</li>
          <li>You can skip: `project:gateway_proxy`, `project:read_otlp`, `project:write_otlp` (not needed for this integration).</li>
          <li>Check <strong>All Projects</strong> to allow access across all projects in the organization.</li>
          <li>Click <strong>Create</strong> to generate the key.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy the API Key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The API key is shown only once after creation. Copy it immediately and store it securely.</p>

        <ul>
          <li>The key starts with `pylf_v2_eu_` (EU) or `pylf_v2_us_` (US).</li>
          <li>If you lose the key, you must create a new one.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Determine Your API Region URL</h2>

  <p>Logfire supports two data regions. Use the base URL that matches the region where your account was created.</p>

  <ul>
    <li><strong>EU Region</strong>: `https://api-eu.pydantic.dev`</li>
    <li><strong>US Region</strong>: `https://api-us.pydantic.dev`</li>
  </ul>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Free Plan Limits</h2>

  <p>The Logfire Personal Plan (free) includes the following limits.</p>

  <ul>
    <li><strong>Projects</strong>: 3</li>
    <li><strong>Seats</strong>: 1</li>
    <li><strong>Guests</strong>: 2</li>
    <li><strong>Logs/Spans/Metrics</strong>: 10 million per month</li>
  </ul>
</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>API Region URL</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>