Airtable

Access the Airtable API in 2 minutes 💨

🚀 Quickstart

1. Create an integration

   In Nango (free signup), go to Integrations -> Configure New Integration -> Airtable.

2. Authorize Airtable

   Go to Connections -> Add Test Connection -> Authorize, then log in to Airtable. Later, you’ll let your users do the same directly from your app.

3. Call the Airtable API

   Let’s make your first request to the Airtable API (fetch records from a table). Replace the placeholders below with your secret key, integration ID, and connection ID:

   cURL

   curl "https://api.nango.dev/proxy/v0/meta/bases" \
     -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
     -H "Provider-Config-Key: <INTEGRATION-ID>" \
     -H "Connection-Id: <CONNECTION-ID>"
   

   Node

   Install Nango’s backend SDK with npm i @nangohq/node. Then run:

   import { Nango } from '@nangohq/node';
   
   const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });
   
   const res = await nango.get({
       endpoint: '/v0/meta/bases',
       providerConfigKey: '<INTEGRATION-ID>',
       connectionId: '<CONNECTION-ID>'
   });
   
   console.log(res.data);
   

   Or fetch credentials dynamically via the Node SDK or API.

✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Next step: Embed the auth flow in your app to let your users connect their Airtable accounts.

🧑‍💻 OAuth app setup

1. Create an Airtable account

   If you don’t already have one, sign up for an Airtable account.

2. Register a new OAuth integration

   1. Go to the OAuth integrations panel in your Airtable account.
   2. Click Register new OAuth integration.
   3. Enter a unique name for your integration.
   4. Add https://api.nango.dev/oauth/callback as your OAuth redirect URI.
   5. Click Register integration.
3. Configure OAuth scopes and details

   1. Select the scopes your application requires.
   2. Add optional details like tagline, homepage URL, and logo.
   3. For public integrations, add required fields: support email, privacy policy URL, and terms of service URL.
   4. Click Save changes.
4. Generate credentials

   1. Click Generate client secret and confirm the action.
   2. Copy the Client Secret (you’ll only see it once).
   3. Note your Client ID from the integration management page.
   4. You’ll need both when configuring your integration in Nango.
5. Next

   Follow the Quickstart.

Common Scopes

Scope	Description
data.records:read	Read records from bases.
data.records:write	Create, update, and delete records.
schema.bases:read	Read base schema (table/field names and types).
data.recordComments:read	Read comments on records.
data.recordComments:write	Create and delete record comments.
user.email:read	Read the email of the authenticated user.
workspacesAndBases:read	List the user’s workspaces and bases to select from.

🔗 Useful links

Topic	Links
General	Airtable Website
	Create an Airtable account
	OAuth Integrations Panel
Developer	Web API Documentation
	OAuth Reference
	OAuth Integrations Guide
	OAuth Scopes
	Authentication Reference
	Rate Limits
	SCIM API Documentation
	Example OAuth Setup Repository

Contribute useful links by editing this page

🚨 API gotchas

• During the OAuth flow, users can decide which resources (Bases) your app should have access to. This means your app might not have access to all bases in their workspace.
• Airtable requires specific scopes for different operations. Make sure to request all necessary scopes during OAuth setup.
• Rate limits apply per workspace, not per integration, so high-volume usage might affect other integrations in the same workspace.

Contribute API gotchas by editing this page

Questions? Join us in the Slack community.