DocsConnectors

Airtable

Airtable logo

Airtable

This connector enables AI agents and RAG systems to retrieve context from Airtable through Airweave’s unified search layer.

Configuration

Airtable source connector integrates with the Airtable API to extract and synchronize data.

Connects to your Airtable bases and syncs everything by default:

  • User info (authenticated user)
  • All accessible bases
  • All tables in each base
  • All records in each table
  • All comments on each record
  • All attachments in each record

No configuration needed - just connect and sync!

View Source Code

Explore the Airtable connector implementation

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Airweave UI or API using the OAuth flow.

Supported authentication methods:

  • OAuth Browser Flow (recommended for UI)
  • OAuth Token (for programmatic access)
  • Auth Provider (enterprise SSO)

Configuration Options

This connector does not have any additional configuration options.

Data Models

The following data models are available for this connector:

The authenticated user (from /meta/whoami endpoint).

FieldTypeDescription
user_idstrAirtable user ID
display_namestrDisplay name derived from email or ID
emailOptional[str]User email address
scopesOptional[List[str]]OAuth scopes granted to the token

Metadata for an Airtable base.

FieldTypeDescription
base_idstrAirtable base ID
namestrBase name
permission_levelOptional[str]Permission level for this base
urlOptional[str]URL to open the base in Airtable (legacy API field)

Metadata for an Airtable table (schema-level info).

FieldTypeDescription
table_idstrAirtable table ID
namestrTable name
base_idstrParent base ID
descriptionOptional[str]Table description, if any
fields_schemaOptional[List[Dict[str, Any]]]List of field definitions from the schema API
primary_field_nameOptional[str]Name of the primary field
view_countOptional[int]Number of views in this table

One Airtable record (row) as a searchable chunk.

FieldTypeDescription
record_idstrRecord ID
namestrRecord display name
created_atOptional[datetime]Record creation time
base_idstrParent base ID
table_idstrParent table ID
table_nameOptional[str]Parent table name
fieldsDict[str, Any]Raw Airtable fields map

A comment on an Airtable record.

FieldTypeDescription
comment_idstrComment ID
namestrComment preview
created_atOptional[datetime]When the comment was created
updated_atOptional[datetime]When the comment was last updated
record_idstrParent record ID
base_idstrParent base ID
table_idstrParent table ID
textstrComment text
author_idOptional[str]Author user ID
author_emailOptional[str]Author email address
author_nameOptional[str]Author display name

Attachment file from an Airtable record.

FieldTypeDescription
attachment_idstrAttachment ID (or composite key)
namestrAttachment filename
base_idstrBase ID
table_idstrTable ID
table_nameOptional[str]Table name
record_idstrRecord ID
field_namestrField name that contains this attachment