> ## Documentation Index
> Fetch the complete documentation index at: https://docs.subverseai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Airtable Token API Credentials

> How to create and configure Airtable Token API credentials for SubverseAI

# Airtable Token API Credentials

Airtable Token API credentials allow your SubverseAI agents to authenticate with Airtable using personal access tokens for direct API access.

## Overview

Airtable Token credentials provide access to:

* Direct API access with personal tokens
* Simplified authentication flow
* Personal workspace integration
* High-frequency operations
* Development and testing workflows

## Dashboard Screenshot

![Airtable Developer Hub](https://example.com/screenshots/airtable-token-dashboard.png)
*Create personal access tokens in the [Airtable Developer Hub](https://airtable.com/create/tokens)*

## Steps to Create Airtable Token API Credentials

### 1. Create Airtable Account

1. Visit [Airtable](https://airtable.com)
2. Sign up or sign in to your account
3. Create or select a workspace

### 2. Generate Personal Access Token

1. Navigate to the [Developer Hub](https://airtable.com/create/tokens)
2. Click **Create new token**
3. Enter token details:
   * **Name**: Descriptive name (e.g., "SubverseAI Token Integration")
   * **Scopes**: Select required permissions:
     * `data.records:read` - Read records
     * `data.records:write` - Create/update/delete records
     * `data.bases:read` - Read base information
     * `schema.bases:read` - Read base schema
4. Select workspaces to grant access to
5. Click **Create token**
6. Copy the token immediately - it won't be shown again

### 3. Get Base Information

1. Open your Airtable base
2. From the URL, copy the **Base ID**
3. Note the **Table IDs** for tables you want to access

### 4. Add to SubverseAI

1. Go to **Credentials** in your SubverseAI dashboard
2. Click **Create New Credential**
3. Select **Airtable Token API** from the credential types
4. Enter a name for your credential
5. Fill in the required fields:
   * **Personal Access Token**: Your Airtable token (starts with `pat`)
   * **Base ID** (optional): Default base ID for operations
6. Click **Test Connection** to verify the credentials work
7. Click **Save Credential**

## Required Fields

* **Name**: A descriptive name for your credential
* **Personal Access Token**: Your Airtable personal access token
* **Base ID** (optional): Default base ID for operations

## Usage Tips

* Use specific scopes to limit token permissions
* Create separate tokens for different environments
* Regularly rotate your access tokens
* Use base and table IDs rather than names for reliability

## Troubleshooting

**Invalid Token**: Ensure you copied the complete token including the `pat` prefix

**Permission Denied**: Check that your token has the required scopes and workspace access

**Base Not Found**: Verify the Base ID is correct and you have access to that base

**Rate Limit Exceeded**: Airtable has API rate limits - implement retry logic

## Next Steps

After creating your Airtable Token credentials:

* Set up direct API integration workflows
* Configure high-frequency data operations
* Build real-time data synchronization
* Monitor API usage and performance
* Implement token rotation procedures