Airtable
Overview
Pre-built tooling
Pre-built integrations
Access requirements
Pre-Requisites | Status | Comment |
---|---|---|
Paid dev account | ✅ Not required | Free, self-signup for an Airtable account. |
Paid test account | ✅ Not required | Free Airtable account can be used for testing. |
Partnership | ✅ Not required | |
App review | ✅ Not required | No app review process for OAuth integrations. |
Security audit | ✅ Not required |
Setup guide
Create an Airtable account
If you don’t already have one, sign up for an Airtable account.
Register a new OAuth integration
- Go to the OAuth integrations panel in your Airtable account.
- Click Register new OAuth integration.
- Enter a unique name for your integration.
- Add
https://api.nango.dev/oauth/callback
as your OAuth redirect URI. - Click Register integration.
Configure your OAuth integration
After creating your integration, you’ll be taken to the management page where you can configure the following properties:
- Name: You can update the name of your integration if needed.
- OAuth redirect URI: Verify that
https://api.nango.dev/oauth/callback
is set correctly. - Permission scopes: Select the scopes your application requires. Common scopes include:
data.records:read
- Read records from basesdata.records:write
- Create, update, and delete recordsdata.recordComments:read
- Read record commentsdata.recordComments:write
- Create, update, and delete record commentsschema.bases:read
- Read base schema information
- Tagline (optional): Add a brief description of what your integration does.
- Homepage URL (optional): Add your website or homepage URL.
- Logo (optional): Upload a logo for your integration.
- Support email (optional): Add an email address where users can reach you for support.
- Privacy policy URL (required to share integration): Add your privacy policy URL.
- Terms of service URL (required to share integration): Add your terms of service URL.
Click Save changes when you’re done.
Generate a client secret
- On your integration’s management page, click Generate client secret.
- Confirm the action by clicking Generate.
- Copy the client secret that appears. Note that this is the only time you’ll see this secret, so make sure to store it securely.
- Click Done after copying the secret.
Obtain your client ID
Your client ID is displayed on your integration’s management page. You’ll need both the client ID and client secret when configuring your integration in Nango.
Preview the user authorization dialog
You can preview what users will see when authorizing your integration by clicking the Preview authorization dialog button on your integration’s management page.
Make your integration available to users
To make your integration available to other users, you must add:
- A support email
- A privacy policy URL
- A terms of service URL
Once these are added and saved, other users will be able to authorize your integration.
Next
Follow the Quickstart.
Useful links
- Airtable Website
- Create an Airtable account
- OAuth Integrations Panel
- Web API Documentation
- OAuth Reference
- OAuth Integrations Guide
- OAuth Scopes
- Authentication Reference
- Rate Limits
- SCIM API Documentation
- Example OAuth Setup Repository
Scopes
See the full list of available scopes in the Airtable OAuth Scopes documentation.
API gotchas
- During the OAuth flow, the user can decide to which resources (Bases) the app should have access to. Read more here