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

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

<Warning>Only Lusha account Admins or Managers can access the API page and create API keys. The free and starter plans support a single API key — creating multiple named API keys requires upgrading to a paid plan (Professional, Premium, or Scale).</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Generating Your Lusha API Key</h2>

  <p>Your Lusha API key authenticates all requests to Lusha's REST API and MCP server. Keys are tied to your Lusha account and subscription plan, which determines your rate limits and credit allowance.</p>

  <Steps>
    <Step title="Sign in to your Lusha dashboard">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://dashboard.lusha.com/" target="_blank" rel="noopener noreferrer">Lusha dashboard</a> using an Admin or Manager account.</p>
      </div>
    </Step>

    <Step title="Open the API page">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click the <strong>API</strong> link in the top-right header (next to the settings/gear icon), or open the <a href="https://dashboard.lusha.com/api/manage-api-keys" target="_blank" rel="noopener noreferrer">Manage API Keys page</a> directly.</p>

        <ul>
          <li>If you do not see the <strong>API</strong> link in the header, your account may not have API access enabled — contact your Customer Success Manager or Lusha support.</li>
        </ul>
      </div>
    </Step>

    <Step title="Open the Manage API Keys tab">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the Lusha API page, switch from the default <strong>API</strong> tab to the <strong>Manage API Keys</strong> tab to view existing keys and create new ones.</p>
      </div>
    </Step>

    <Step title="Create or copy an API key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click the <strong>+ Create new Key</strong> button at the top right to generate a new key. If a key already exists, you can also copy an existing key from the table - click the eye icon to reveal the masked value, then click the copy icon to copy the full key.</p>

        <ul>
          <li>Format: `00000000-0000-0000-0000-000000000000` (UUID v4)</li>
          <li>Each row in the keys table shows Name, masked Key, Created date, Created by, Last used, and Credit usage with a Set limit option.</li>
          <li>Security: Treat the API key as a secret. Never share it publicly or commit it to version control. Lusha uses the key to track and bill API usage against your account.</li>
          <li>Store the copied key securely for use later.</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>
      </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>