Airtable

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

Configuration

Airtable source connector — syncs bases, tables, records, comments, attachments.

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:

AirtableUserEntity

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

Field	Type	Description
user_id	str	Airtable user ID
display_name	str	Display name derived from email or ID
email	Optional[str]	User email address
scopes	Optional[List[str]]	OAuth scopes granted to the token

AirtableBaseEntity

Metadata for an Airtable base.

Field	Type	Description
base_id	str	Airtable base ID
name	str	Base name
permission_level	Optional[str]	Permission level for this base
url	Optional[str]	URL to open the base in Airtable (legacy API field)

AirtableTableEntity

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

Field	Type	Description
table_id	str	Airtable table ID
name	str	Table name
base_id	str	Parent base ID
description	Optional[str]	Table description, if any
fields_schema	Optional[List[Dict[str, Any]]]	List of field definitions from the schema API
primary_field_name	Optional[str]	Name of the primary field
view_count	Optional[int]	Number of views in this table

AirtableRecordEntity

One Airtable record (row) as a searchable chunk.

Field	Type	Description
record_id	str	Record ID
name	str	Record display name
created_at	Optional[datetime]	Record creation time
base_id	str	Parent base ID
table_id	str	Parent table ID
table_name	Optional[str]	Parent table name
fields	Dict[str, Any]	Raw Airtable fields map

AirtableCommentEntity

A comment on an Airtable record.

Field	Type	Description
comment_id	str	Comment ID
name	str	Comment preview
created_at	Optional[datetime]	When the comment was created
updated_at	Optional[datetime]	When the comment was last updated
record_id	str	Parent record ID
base_id	str	Parent base ID
table_id	str	Parent table ID
text	str	Comment text
author_id	Optional[str]	Author user ID
author_email	Optional[str]	Author email address
author_name	Optional[str]	Author display name

AirtableAttachmentEntity

Attachment file from an Airtable record.

Field	Type	Description
attachment_id	str	Attachment ID (or composite key)
name	str	Attachment filename
base_id	str	Base ID
table_id	str	Table ID
table_name	Optional[str]	Table name
record_id	str	Record ID
field_name	str	Field name that contains this attachment