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 Group, Get Unified Role, Get Unified User, List Bases, List Comments, List Records, List Unified Groups, List Unified Resource Types, List Unified Resource Users, List Unified Roles, List Unified Users, 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

Open the connector

Log in to StackOne, open Connectors, and select Airtable.
2

Choose actions and events

  • Click Add Profile.
  • If the connector offers more than one authentication method, set the Auth Method filter to OAuth 2.0.
  • Select the actions, and any events, to enable for this Connector Profile.
  • Click Continue.
3

Set up authentication

  • Select Authentication Type as OAuth 2.0.
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • Click Create Profile.
Congratulations! The new Connector Profile now shows up on the connector page. If you created it as a project member rather than an admin, it starts disabled until a project admin enables it. You can now continue to Link Accounts for Airtable.