Skip to main content

Airtable

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Airtable account to Nirvai to automate database operations, sync records across bases, and integrate your no-code workflows.

Supported Authentication Methods​

  • Personal Access Token (PAT) - Recommended
  • OAuth2 (for multi-user applications)

Prerequisites​

  • An Airtable account
  • At least one base to connect

Setup Instructions​

Personal Access Tokens are recommended for most use cases as they're simpler to set up and more secure than OAuth for single-user integrations.

Step 1: Create a Personal Access Token​

  1. Go to the Airtable Builder Hub - Personal Access Tokens page
  2. Click + Create new token
  3. Enter a name for your token, like Nirvai Integration

Step 2: Configure Scopes​

Add the following scopes to your token:

  • data.records:read - Read records from bases
  • data.records:write - Create, update, and delete records
  • schema.bases:read - Read base and table structure

Tip: Only add scopes you actually need for your workflows.

Step 3: Select Base Access​

Choose the level of access:

  • Single base: Most secure, only accesses one specific base
  • Multiple bases: Access to selected bases from different workspaces
  • All bases in workspace: Access all current and future bases in a workspace
  • All bases: Full access to all your bases (use with caution)

Step 4: Generate and Copy Token​

  1. Click Create token
  2. Copy the generated token immediately (it won't be shown again)
  3. Paste the token in Nirvai when creating your Airtable credential

Option 2: OAuth2​

OAuth2 is ideal for applications that need to access multiple users' Airtable accounts.

Step 1: Register OAuth Integration​

  1. Go to Airtable Builder Hub - OAuth Integrations
  2. Click Register new OAuth integration
  3. Enter a name for your integration

Step 2: Configure OAuth Settings​

  1. Copy the OAuth Redirect URL from Nirvai's credential creation page
  2. Paste it in Airtable as the OAuth redirect URL
  3. Click Register integration

Step 3: Get Credentials​

  1. Copy the Client ID from Airtable
  2. Click Generate client secret and copy the secret
  3. Enter both in your Nirvai OAuth2 credential

Step 4: Select Scopes​

In Airtable, select the following scopes:

  • data.records:read
  • data.records:write
  • schema.bases:read

Click Save changes in Airtable.

Step 5: Connect​

Click Connect my account in Nirvai and follow the authorization flow.

Troubleshooting​

Token Not Working​

  • Check expiration: Personal Access Tokens don't expire unless you set an expiration date
  • Verify scopes: Ensure you have the required scopes for your operations
  • Check base access: Make sure the token has access to the base you're trying to use

"Unauthorized" Errors​

  • Regenerate your token and update it in Nirvai
  • Verify you're using the correct workspace

Missing Bases in Selection​

  • Check that your token has access to the bases you need
  • For OAuth, ensure the user granted access to the required bases

Documentation adapted for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.