Integration reference
Airtable Trigger and Action reference
Start from Airtable record, field, table, and webhook changes and automate records in selected bases.
Authentication
Connect Airtable through OAuth and grant access to the required bases and tables.
- Trigger account type:
oauth2; reconnect byoauth. - Action connection type:
oauth2; available modes: Connected Airtable account.
Create or reuse the account from a Trigger or Action dialog, or manage it under Settings → Connected accounts. See Authentication and permissions for scopes and access diagnostics, or Connected accounts for reuse, reconnect, revocation, and credential rotation.
Scopes and permissions
Base Trigger authorization requests: data.records:read, schema.bases:read, webhook:manage.
View 3 OAuth scopes used by current Actions
data.records:read, data.records:write, schema.bases:read
View 3 provider permissions or credential requirements
data.records:read, data.records:write, schema.bases:read
Operation-specific requirements appear in the tables below. Custom event selections can add scopes dynamically, so the current Trigger or Action dialog remains authoritative for the exact consent request.
Use Airtable as a Trigger
The current provider manifest contains 13 available Trigger definitions. Representative definitions include:
- Record Created
- Record Updated
- Record Deleted
- Field Updated
- Table Updated
- Webhook Error
View all 13 available Trigger definitions
| Trigger | Manifest key | Delivery | Additional scopes |
|---|---|---|---|
| Any Airtable Change | airtable.any_event.instant | instant | None declared |
| Custom Airtable Changes | airtable.custom_webhook_events.instant | instant | None declared |
| Record Created | airtable.record_created.instant | instant | None declared |
| Record Updated | airtable.record_updated.instant | instant | None declared |
| Record Deleted | airtable.record_deleted.instant | instant | None declared |
| Field Created | airtable.field_created.instant | instant | None declared |
| Field Updated | airtable.field_updated.instant | instant | None declared |
| Field Deleted | airtable.field_deleted.instant | instant | None declared |
| Table Created | airtable.table_created.instant | instant | None declared |
| Table Updated | airtable.table_updated.instant | instant | None declared |
| Table Deleted | airtable.table_deleted.instant | instant | None declared |
| Webhook Error | airtable.webhook_error.instant | instant | None declared |
| Unknown Future Change | airtable.payload_unknown.instant | instant | None declared |
Choose the narrowest event definition that fits the Workflow. Configure provider-specific resource and event filters in the Source dialog before adding broader Workflow Filters.
Use Airtable Actions
The current Action manifest contains 6 operations. Representative Actions include:
- Create Record
- Update Record
- Create Records
- Upsert Records
- Delete Record
- Custom API Request
View all 6 available Action definitions
| Action | Manifest key | Access and auth | Manifest rate limit |
|---|---|---|---|
| Create Record | airtable.create_record | data.records:read, data.records:write, schema.bases:readFastHook-managed account | 5/second |
| Update Record | airtable.update_record | data.records:read, data.records:write, schema.bases:readFastHook-managed account | 5/second |
| Create Records | airtable.create_records | data.records:read, data.records:write, schema.bases:readFastHook-managed account | 5/second |
| Upsert Records | airtable.upsert_records | data.records:read, data.records:write, schema.bases:readFastHook-managed account | 5/second |
| Delete Record | airtable.delete_record | data.records:read, data.records:write, schema.bases:readFastHook-managed account | 5/second |
| Custom API Request | airtable.custom_api_request | data.records:read, data.records:write, schema.bases:readFastHook-managed account | 5/second |
The Action editor reads its required permissions, fields, remote resource pickers, output schema, and rate limit from the provider manifest. Available fields can change with the selected operation and authentication mode.
Build a Workflow
- Create a Source using a Airtable Trigger definition.
- Create a Workflow with that Source as its Trigger.
- Add the required Airtable Action and select the connected account.
- Map Trigger or earlier-Step data into the Action fields with the field picker.
- Add a Filter, Paths, Delay, or Transformation when the route needs it.
- Activate the Workflow, produce a controlled event, and verify the run in Audit and in Airtable.
Troubleshooting Airtable
- The account is missing or cannot be selected
- Confirm the active FastHook team, provider, account status, and authentication mode. A disabled or revoked account cannot execute an Action.
- A resource picker is empty
- Verify that the connected provider identity can access the resource itself. OAuth consent does not add workspace, repository, channel, drive, project, base, or record permissions.
- The editor asks for additional scopes
- Reconnect the same account from the affected Trigger or Action so FastHook can request its current manifest scopes. Then reopen the editor and select the resource again.
- An active Workflow returns 401, 403, or a permission error
- Compare the selected operation’s access requirements below with the account recorded in Audit. Check provider-side membership and object access before repeating the Action.
- The provider returns 429 or a temporary 5xx
- Inspect the Step attempt and retryability in Audit. FastHook can retry temporary failures, but provider quotas and idempotency rules still apply.
Provider-specific checks
- Base, table, field, and change-source filters reduce event volume.
- Use upsert only with a stable matching field and test duplicate cases.