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
  • workspacesAndBases:read — View workspace and base collaborators
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.

SCIM API Token for User and Group Sync (Optional)

The unified user and group actions read Airtable’s SCIM API, which requires its own token — separate from the Personal Access Token above.

1

Check the requirements

SCIM access is only available on qualifying Airtable plans with single sign-on configured.

  • Requires a Business, Enterprise, or Enterprise Scale plan
  • SAML SSO must be enabled for your organization
  • Leave the SCIM API Token field blank if you do not need user and group sync — all other actions work without it
2

Generate the SCIM token

Create a token with the SCIM scope as an Enterprise admin.

  • Sign in as an Enterprise admin and open airtable.com/create/tokens
  • Create a token with the enterprise.scim.usersAndGroups:manage scope
  • Copy the token and paste it into the SCIM API Token field when connecting the account
  • Refer to the Airtable SCIM overview for more details

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
  • SCIM API Token (Optional)
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.