Skip to main content
You need an Airtable account with Owner or Creator permissions on the bases you want to integrate.

Generate a Personal Access Token

Create a Personal Access Token in the Airtable Builder Hub to authenticate API requests.

1

Open the Builder Hub

Navigate to the Airtable Builder Hub where Personal Access Tokens are managed.

  • Sign in to your Airtable account
  • Click your account profile icon in the top-right corner
  • Select Builder Hub from the dropdown menu
2

Navigate to Personal Access Tokens

Find the Personal Access Tokens section in the Builder Hub.

  • In the left sidebar, locate the Developers section
  • Click Personal access tokens
3

Create a new token

Generate a new token with the required permissions.

  • Click Create new token
  • Enter a descriptive name for the token (e.g., StackOne Integration)
4

Configure scopes

Add the scopes your integration requires. Select the minimum scopes needed for your use case.

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

Select base access

Choose which bases the token can access.

  • Under Access, click + Add a base to grant access to specific bases
  • Alternatively, select All current and future bases in all current and future workspaces for full access
  • Restricting access to specific bases is recommended for security
6

Create and copy the token

Finalize the token creation and securely store it.

  • Click Create token to generate the token
  • Important: Copy the token immediately and store it securely. The token is only displayed once and cannot be retrieved again.

Important Notes

Key information about Airtable Personal Access Tokens.

  • Personal Access Tokens authenticate as your user account with the permissions you selected
  • Tokens do not expire automatically but can be revoked at any time from the Builder Hub
  • You can create multiple tokens with different scopes for different integrations
  • If a token is lost, you must create a new one with the same settings
  • Refer to the Airtable Personal Access Tokens documentation for more details

Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Personal Access Token
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.