> ## 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 Airtable with Personal Access Token – StackOne Hub

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

<Warning>You need an Airtable account with Owner or Creator permissions on the bases you want to integrate.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Generate a Personal Access Token</h2>

  <p>Create a Personal Access Token in the Airtable Builder Hub to authenticate API requests.</p>

  <Steps>
    <Step title="Open the Builder Hub">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Navigate to the Airtable Builder Hub where Personal Access Tokens are managed.</p>

        <ul>
          <li>Sign in to your <a href="https://airtable.com/" target="_blank" rel="noopener noreferrer">Airtable account</a></li>
          <li>Click your account profile icon in the top-right corner</li>
          <li>Select <strong>Builder Hub</strong> from the dropdown menu</li>
        </ul>
      </div>
    </Step>

    <Step title="Navigate to Personal Access Tokens">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Find the Personal Access Tokens section in the Builder Hub.</p>

        <ul>
          <li>In the left sidebar, locate the <strong>Developers</strong> section</li>
          <li>Click <strong>Personal access tokens</strong></li>
        </ul>
      </div>
    </Step>

    <Step title="Create a new token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Generate a new token with the required permissions.</p>

        <ul>
          <li>Click <strong>Create new token</strong></li>
          <li>Enter a descriptive name for the token (e.g., StackOne Integration)</li>
        </ul>
      </div>
    </Step>

    <Step title="Configure scopes">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Add the scopes your integration requires. Select the minimum scopes needed for your use case.</p>

        <ul>
          <li>Click <strong>+ Add a scope</strong> to add each required scope</li>
          <li><strong>user.email:read</strong> — Required for connection verification</li>
          <li><strong>data.records:read</strong> — View record data</li>
          <li><strong>data.records:write</strong> — Create, edit, and delete records</li>
          <li><strong>schema.bases:read</strong> — View base structure (tables, fields)</li>
          <li><strong>schema.bases:write</strong> — Modify base structure</li>
          <li><strong>data.recordComments:read</strong> — View record comments</li>
          <li><strong>data.recordComments:write</strong> — Create, edit, and delete comments</li>
          <li><strong>webhook:manage</strong> — Create and manage webhooks</li>
        </ul>
      </div>
    </Step>

    <Step title="Select base access">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Choose which bases the token can access.</p>

        <ul>
          <li>Under <strong>Access</strong>, click <strong>+ Add a base</strong> to grant access to specific bases</li>
          <li>Alternatively, select <strong>All current and future bases in all current and future workspaces</strong> for full access</li>
          <li>Restricting access to specific bases is recommended for security</li>
        </ul>
      </div>
    </Step>

    <Step title="Create and copy the token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Finalize the token creation and securely store it.</p>

        <ul>
          <li>Click <strong>Create token</strong> to generate the token</li>
          <li><strong>Important:</strong> Copy the token immediately and store it securely. The token is only displayed once and cannot be retrieved again.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Important Notes</h2>

  <p>Key information about Airtable Personal Access Tokens.</p>

  <ul>
    <li>Personal Access Tokens authenticate as your user account with the permissions you selected</li>
    <li>Tokens do not expire automatically but can be revoked at any time from the Builder Hub</li>
    <li>You can create multiple tokens with different scopes for different integrations</li>
    <li>If a token is lost, you must create a new one with the same settings</li>
    <li>Refer to the <a href="https://airtable.com/developers/web/guides/personal-access-tokens" target="_blank" rel="noopener noreferrer">Airtable Personal Access Tokens documentation</a> for more details</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>Personal Access Token</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>
