Airtable

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!

Source Code: View on GitHub

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Graffo 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