Airtable Webhook for n8n

n8n community node that triggers workflows instantly when Airtable records change — using real Airtable webhooks, not polling.

Originally forked from @vwork-digital/n8n-nodes-instant-airtable-trigger, fully rewritten by D1DX.

How It Works

1. Activate a workflow with this trigger — registers an Airtable webhook on your base
2. Airtable sends a notification ping to n8n on every matching change
3. The node fetches the webhook payloads with cursor-based pagination
4. Payloads are parsed into flat per-record items with field names resolved
5. Deactivate the workflow — webhook is automatically deleted

Important: Airtable webhooks expire every 7 days. Use a separate scheduled workflow to refresh them.

Installation

1. Go to Settings > Community Nodes in your n8n instance
2. Click Install a community node
3. Enter @d1dx/n8n-nodes-airtable
4. Click Install

Or via CLI:

cd ~/.n8n
npm install @d1dx/n8n-nodes-airtable
# Restart n8n

Configuration

All field names map directly to the Airtable Webhooks API specification.

Core Fields (always visible)

| Field | Airtable API | Description | |-------|-------------|-------------| | Base | — | Dropdown of all bases (via meta API) | | Table | — | Dropdown of tables in selected base | | View | recordChangeScope | Scope to a specific view. "Add" = entered view, "Remove" = left view. Form/List views not supported. Leave empty for entire table. | | Change Types | changeTypes | Add / Update / Remove. Leave empty = all. Sent server-side to Airtable. |

Shown when "Update" is selected

| Field | Airtable API | Description | |-------|-------------|-------------| | Fields to Watch | watchDataInFieldIds | Only trigger on changes to these fields. Leave empty = all fields. Warning: webhook permanently stops if a listed field is deleted. | | Include Previous Values | includePreviousCellValues | Include the previous value alongside current for changed fields. |

Output Options (always visible)

| Field | Airtable API | Description | |-------|-------------|-------------| | Fields to Include in Output | includeCellValuesInFieldIds | Always include these field values, even if unchanged. Select "All fields" to send "all" to API. Safe if a listed field is deleted. | | Use Field Names | — | Resolve field IDs (e.g. fldABC123) to human names (e.g. Status) in output. |

Advanced Options

| Field | Airtable API | Description | |-------|-------------|-------------| | Data Types | dataTypes | tableData (default), tableFields, tableMetadata. Can combine multiple. | | From Sources | fromSources | Filter by source: client, publicApi, automation, formSubmission, formPageSubmission, sync, system, anonymousUser, unknown. Empty = all. | | Form Submission View ID | sourceOptions.formSubmission.viewId | Filter form submissions to a specific form view. Only relevant when "Form Submission" is in From Sources. | | Form Page Submission Page ID | sourceOptions.formPageSubmission.pageId | Filter interface page submissions to a specific page. Only relevant when "Form Page Submission" is in From Sources. | | Watch Field Schema Changes | watchSchemasOfFieldIds | Only trigger on schema changes for these fields. Requires tableFields data type. Warning: webhook stops if field is deleted. | | Include Previous Field Definitions | includePreviousFieldDefinitions | Include previous field name/type in field change payloads. Requires tableFields data type. |

Credentials

You need an Airtable Personal Access Token (PAT):

1. Go to airtable.com/create/tokens
2. Create a token with these scopes:
   • webhook:manage — register and delete webhooks
   • data.records:read — read webhook payloads
   • schema.bases:read — populate base/table/view/field dropdowns
3. Grant access to the bases you want to watch
4. In n8n, create an "Airtable API" credential and paste the token

Output Format

One item per event. All items include eventType, recordId, tableId, source, changedBy, timestamp.

Record events (tableData)

Created:

{
  "eventType": "created",
  "recordId": "recXXXXXXXXXXXXXX",
  "tableId": "tblXXXXXXXXXXXXXX",
  "viewId": "viwXXXXXXXXXXXXXX",
  "createdTime": "2026-04-05T12:00:00.000Z",
  "fields": { "Status": "New", "Name": "Example" },
  "source": "client",
  "changedBy": { "userId": "usrXXXX", "userName": "John", "userEmail": "[email protected]" },
  "timestamp": "2026-04-05T12:00:00.000Z"
}

Updated:

{
  "eventType": "updated",
  "recordId": "recXXXXXXXXXXXXXX",
  "tableId": "tblXXXXXXXXXXXXXX",
  "changedFields": ["Status"],
  "current": { "Status": "Done" },
  "previous": { "Status": "Active" },
  "unchanged": { "Name": "Example" },
  "source": "client",
  "changedBy": { "userId": "usrXXXX", "userName": "John", "userEmail": "[email protected]" },
  "timestamp": "2026-04-05T12:00:00.000Z"
}

Deleted:

{
  "eventType": "deleted",
  "recordId": "recXXXXXXXXXXXXXX",
  "tableId": "tblXXXXXXXXXXXXXX",
  "source": "client",
  "timestamp": "2026-04-05T12:00:00.000Z"
}

Field schema events (tableFields)

| eventType | Key fields | |-----------|-----------| | fieldCreated | fieldId, name, type | | fieldChanged | fieldId, current, previous | | fieldDeleted | fieldId |

Table metadata events (tableMetadata)

| eventType | Key fields | |-----------|-----------| | metadataChanged | current (name, description), previous |

Error events

| eventType | Key fields | |-----------|-----------| | error | code: INVALID_FILTERS, INVALID_HOOK, or INTERNAL_ERROR |

Gotchas

• View-scoped payloads have different structure. When recordChangeScope is a view, Airtable nests records inside changedViewsById instead of directly on the table. The node handles this transparently.
• 10 webhooks per base. Each active workflow uses one webhook. Plan accordingly.
• Webhooks expire in 7 days. Refresh them or they stop silently.
• Field deletion kills the webhook. If a field in watchDataInFieldIds or watchSchemasOfFieldIds is deleted, the webhook enters a permanent error state. Must deactivate and reactivate. Exception: includeCellValuesInFieldIds is safe — deleted fields are silently ignored.
• Creator permissions required. The PAT owner must have Creator access to register webhooks.
• Community node updates require n8n restart. n8n loads node code at startup, not dynamically.

Credits

Originally created by Jacob Vendramin at vwork Digital as @vwork-digital/n8n-nodes-instant-airtable-trigger (MIT license). Forked and rewritten by D1DX.

License

MIT — see LICENSE.md

Resources

• Airtable Webhooks API
• Airtable Create Webhook
• Airtable Webhook Payloads
• n8n Community Nodes