Airtable

Use Airtable when you want a workflow step to create, list, update, or retrieve records in an Airtable base from a connected account.

Configuration

Option	Required	Description
Name	No	Label for the step in the workflow canvas.
Authentication	Yes	The connected Airtable account to use for this step.
Action	Yes	The Airtable action to perform (Create Record, List Records, Update Record, Get Record).
Arguments	Yes	Per-action form fields generated from the action’s schema. Each text field has an Insert Variable button for injecting `{{placeholder}}` values. A Raw JSON tab is available for advanced usage.
When the step fails	No	Controls whether the workflow should Terminate Workflow or Continue if this step fails.

Before you configure this step, connect Airtable in Integrations for your workspace using the OAuth flow. If no active Airtable connection is available, the step shows a warning with a link to Integrations instead of the account selector.

Arguments form

When you select an action, the Arguments section automatically renders a form driven by the action’s input schema — no manual JSON editing required. Each field includes:

A label and description from the action’s schema.
An Insert Variable button next to the label that injects references like {{step_1.output.id}} at the cursor position.
Validation feedback inline if a required field is left empty.

Field types

Field type	How it renders	Insert Variable available
Text / number	Plain input.	Create Record and Update Record only
Boolean	Toggle switch (label on the left, switch on the right).	No
Base ID (`baseId`)	Dropdown populated from your connected Airtable account — select your base by name. Use Enter custom value for a base ID or `{{variable}}`.	Manual entry only
Record ID (`recordId`)	Dropdown populated after Base ID and Table ID or Name are set — lists records from that table.	Manual entry only
Fields	A JSON textarea (mono font). Paste a raw JSON object or use Insert Variable to pass a `{{step_1.record}}` placeholder when the fields come from a previous step’s output.	Always
Records (`records`)	A JSON textarea on Create Records and Update Multiple Records. Paste a JSON array (for example `[{"fields":{"Name":"Alice"}}]`) or use Insert Variable to pass output from a previous step such as `{{data_transform.output}}`.	Always
Tag list / array	List of text inputs. The Add button appears next to the array label.	No (array items do not support variable insertion)

Switch to the Raw JSON tab for power users or when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

Actions

Action	Description
Create Record	Create a new record in a specified table.
List Records	List records from a table with optional filtering.
Update Record	Modify an existing record by ID.
Get Record	Retrieve a single record by ID.

Output

This step stores the Airtable API response as the step output. The shape of the response depends on the action. Use the full output reference in later steps:

{{STEP_IDENTIFIER.output}}

For example, after a Create Record step you might reference the new record’s ID:

{{step_2.output.id}}

Example

Open Integrations and connect Airtable if you have not already done that.
Add an Airtable step to your workflow.
Select a connected account in Authentication.
Choose Create Record in Action.
In the Arguments form, fill in Table ID and the field values. Use Insert Variable to reference an earlier step’s output for any field value.
Click Run in the step header to test the action, then review the returned payload in Output.

Notes

This step depends on a connected Airtable integration in your workspace.
The Raw JSON tab in Arguments is always available if you prefer to write JSON directly.
The tableId is the Airtable table identifier (starts with tbl).

Using Airtable as an Agent Tool

You can also add Airtable as a tool in the Agent Editor. Open the agent, click Add tool, and select Airtable. In the tool settings panel, choose the connected Airtable account the agent should use. The agent will call Airtable actions automatically during conversations when relevant. See also: Integrations, Creating and Editing, and Testing and Iteration

Getting Started

Live Chat

Prompts

Workflows

Hive Agents

Agents

Knowledge Bases

Experiments

Your Workspace

Monitoring

User Tracking

Resources

Configuration

Arguments form

Field types

Actions

Output

Example

Notes

Using Airtable as an Agent Tool

​Configuration

​Arguments form

​Field types

​Actions

​Output

​Example

​Notes

​Using Airtable as an Agent Tool

Configuration

Arguments form

Field types

Actions

Output

Example

Notes

Using Airtable as an Agent Tool