Airtable

Authentication

Airtable OAuth requires PKCE and uses scopes:

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

Endpoints

records.list

List records in a table with filtering, sorting, and pagination.

Input:

Output: { records: AirtableRecord[]; offset?: string }

records.get

Get a single record by ID.

Input:

Output: AirtableRecord

records.create

Create up to 10 records in one call.

Input:

Output: { records: AirtableRecord[] }

records.update

Update up to 10 records with partial fields.

Input:

Output: { records: AirtableRecord[] }

records.delete

Delete up to 10 records.

Input:

Output: { records: Array<{ id: string; deleted: boolean }> }

webhooks.listPayloads

Poll buffered webhook payloads for a subscription. Airtable webhooks require polling — push events only notify "something changed."

Input:

Output: { payloads: unknown[]; cursor: number; mightHaveMore: boolean; payloadFormat: "v0" }

Usage

import { createFabric } from "@fabricorg/integrations";
import { airtable } from "@fabricorg/integrations/plugins";

const fabric = createFabric({
  plugins: [airtable({ apiKey: process.env.AIRTABLE_PAT })],
});

// List records
const { records } = await fabric.airtable.api.records.list({
  baseId: "appABCDEF123456",
  tableIdOrName: "Tasks",
  filterByFormula: '{Status} = "In Progress"',
  sort: [{ field: "Due Date", direction: "asc" }],
});

// Create records
const { records: created } = await fabric.airtable.api.records.create({
  baseId: "appABCDEF123456",
  tableIdOrName: "Tasks",
  records: [
    { fields: { Name: "New Task", Status: "Todo", Priority: "High" } },
  ],
});

Webhooks

Airtable's webhook contract requires polling. Push events notify "something changed in baseId," then you poll for payloads via webhooks.listPayloads. The portal's webhook bridge handles the poll loop.

Direct webhook handlers are not declared on this plugin.

Types

interface AirtableRecord<Fields = Record<string, unknown>> {
  id: string;
  fields: Fields;
  createdTime: string;
}