Skip to main content
You need an Airtable account to register an OAuth integration in the Developer Hub.

​
Register an OAuth Integration

Create a new OAuth integration in the Airtable Developer Hub to obtain your Client ID and Client Secret.

1

Access the Developer Hub

Navigate to the Airtable Developer Hub where OAuth integrations are managed.

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

Navigate to OAuth integrations

Open the OAuth integrations page to register a new app.

  • In the left sidebar, click OAuth integrations
  • Click the Register an OAuth integration button
3

Enter integration details

Fill in the required information for your OAuth integration.

  • Enter a Name for the integration (e.g., StackOne Integration)
  • Enter the OAuth redirect URL: https://api.stackone.com/connect/oauth2/airtable/callback
  • Click Register integration to create the app

​
Configure Scopes and Permissions

Set up the required scopes for your OAuth integration to access Airtable data.

1

Add required scopes

Enables actions: Create Base, Create Comment, Create Field, Create Records, Create Table, Create Webhook, Delete Comment, Delete Record, Delete Webhook, Get Base Schema, Get Current User, Get Record, Get Unified Credentials, Get Unified Role, List Bases, List Comments, List Records, List Unified Resource Types, List Unified Resource Users, List Unified Roles, List Webhook Payloads, List Webhooks, Refresh Webhook, Replace Record, Update Comment, Update Field, Update Multiple Records, Update Record, Update Table

Scroll to the Scopes section on the integration settings page and select each required scope by clicking the checkbox next to it. Choose the minimum scopes needed for your use case.

2

Save your changes

Apply the scope configuration.

  • Click Save changes to apply the selected scopes.
  • A confirmation message will appear when changes are saved.

​
Retrieve Client Credentials

Copy your Client ID and Client Secret for use with StackOne.

1

Copy the Client ID

Find and copy your integration’s Client ID.

  • On the integration settings page, locate the Client ID field
  • Copy the Client ID value
2

Generate and copy the Client Secret

Generate a Client Secret for your integration.

  • Click Generate a client secret
  • Important: Copy the Client Secret immediately and store it securely. The secret is only displayed once and cannot be retrieved again.

​
Important Notes

Key information about Airtable OAuth 2.0 authentication.

  • Airtable OAuth uses PKCE (Proof Key for Code Exchange) for enhanced security
  • Access tokens expire after 2 hours and are automatically refreshed using the refresh token
  • Users will be prompted to select which bases the integration can access during the authorization flow
  • If the Client Secret is lost, you can generate a new one from the integration settings page
  • Refer to the Airtable OAuth documentation for more details

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Airtable:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Airtable
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Airtable.