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

​
Configuration

OptionRequiredDescription
NameNoLabel for the step in the workflow canvas.
AuthenticationYesThe connected Airtable account to use for this step.
ActionYesThe Airtable action to perform (Create Record, List Records, Update Record, Get Record).
ArgumentsYesPer-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 failsNoControls whether the workflow should Terminate Workflow or Continue if this step fails.
Before you configure this step, connect Airtable in Integrations for your workspace. 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 typeHow it rendersInsert Variable available
Text / numberPlain input.Create Record and Update Record only
BooleanToggle 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.No
FieldsA 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
Tag list / arrayList 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

ActionDescription
Create RecordCreate a new record in a specified table.
List RecordsList records from a table with optional filtering.
Update RecordModify an existing record by ID.
Get RecordRetrieve 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

  1. Open Integrations and connect Airtable if you have not already done that.
  2. Add an Airtable step to your workflow.
  3. Select a connected account in Authentication.
  4. Choose Create Record in Action.
  5. 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.
  6. 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