> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Airtable

> Configure a workflow step that reads or writes Airtable records using a connected Airtable account

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. 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.                                                                                           | No                                                 |
| 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                                             |
| 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:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

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

```text theme={null}
{{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**.

{/* Add screenshot: Airtable step output tab after a test run */}

## 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](../../../workspace/integrations), [Creating and Editing](../../creating-and-editing), and [Testing and Iteration](../../testing-and-iteration)