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

# Airtable for Workflows

> Trigger Workflows from Airtable record changes and automate record creation, updates, and deletion.

Use Airtable as a trigger or a set of actions in your [Workflows](/workflows/overview). Start a Workflow when records are created, updated, or deleted — and use Airtable actions to read and write records as part of any automation.

<Info>Airtable Workflow actions and triggers require a paid Cassidy plan.</Info>

## Connect your account

1. Open an Airtable trigger or action in the [Workflow builder](/workflows/overview).
2. Click **Connect**.
3. Sign in with Airtable.
4. Click **Add all resources** to grant access to all your bases, or **Add a base** to select specific ones.

## Triggers

### Record created

Starts a Workflow when a new record is added to a table.

**Configuration**

| Field     | Description                        |
| --------- | ---------------------------------- |
| **Base**  | The Airtable base to watch         |
| **Table** | The table to watch for new records |

**Output variables**

| Variable              | Description                                    |
| --------------------- | ---------------------------------------------- |
| **Created Record ID** | The unique identifier of the new record        |
| **Created Time**      | Timestamp when the record was created          |
| **Values**            | List of field IDs and values on the new record |

***

### Record updated

Starts a Workflow when an existing record is modified. Optionally, limit the trigger to fire only when specific fields change.

**Configuration**

| Field              | Description                                                                        |
| ------------------ | ---------------------------------------------------------------------------------- |
| **Base**           | The Airtable base to watch                                                         |
| **Table**          | The table to watch for updates                                                     |
| **Watched fields** | *(Optional)* Specific fields to watch. Leave empty to trigger on any field change. |

**Output variables**

| Variable              | Description                                          |
| --------------------- | ---------------------------------------------------- |
| **Updated Record ID** | The unique identifier of the updated record          |
| **Updated Time**      | Timestamp when the record was last modified          |
| **Record Values**     | All field IDs and their current values on the record |

***

### Record deleted

Starts a Workflow when a record is removed from a table.

**Configuration**

| Field     | Description                      |
| --------- | -------------------------------- |
| **Base**  | The Airtable base to watch       |
| **Table** | The table to watch for deletions |

**Output variables**

| Variable              | Description                                 |
| --------------------- | ------------------------------------------- |
| **Deleted Record ID** | The unique identifier of the deleted record |
| **Deleted Time**      | Timestamp when the record was deleted       |

## Actions

### List records

Retrieves records from an Airtable table. Use this to look up data in a base and pass it to later steps in your Workflow.

**Configuration**

| Field           | Description                                                        |
| --------------- | ------------------------------------------------------------------ |
| **Base**        | The base containing the table                                      |
| **Table**       | The table to retrieve records from                                 |
| **Max records** | *(Optional)* Maximum number of records to return. Defaults to 100. |

**Output variables**

| Variable    | Description                                                                                |
| ----------- | ------------------------------------------------------------------------------------------ |
| **Records** | List of records, each with a Record ID, Created Time, and a list of field names and values |

***

### Add record

Creates a new record in a table with the field values you specify.

**Configuration**

| Field      | Description                                                                                                                                         |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Base**   | The base containing the table                                                                                                                       |
| **Table**  | The table to add the record to                                                                                                                      |
| **Fields** | One or more field–value pairs to populate on the new record. Values support [variables](/workflows/advanced/utility-variables) from previous steps. |

**Output variables**

| Variable         | Description                                          |
| ---------------- | ---------------------------------------------------- |
| **Record ID**    | The unique identifier of the created record          |
| **Created Time** | Timestamp when the record was created                |
| **Fields**       | List of field names and values on the created record |

***

### Update record

Updates one or more fields on an existing record.

**Configuration**

| Field         | Description                                                                                                                     |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Base**      | The base containing the table                                                                                                   |
| **Table**     | The table containing the record                                                                                                 |
| **Record ID** | The ID of the record to update. Reference this from a trigger or a previous List Records step.                                  |
| **Fields**    | One or more field–value pairs to update. Values support [variables](/workflows/advanced/utility-variables) from previous steps. |

**Output variables**

| Variable      | Description                                     |
| ------------- | ----------------------------------------------- |
| **Record ID** | The unique identifier of the updated record     |
| **Fields**    | List of field names and values after the update |

***

### Delete record

Permanently removes a record from a table.

<Warning>This action cannot be undone. The record will be permanently deleted from Airtable.</Warning>

**Configuration**

| Field         | Description                     |
| ------------- | ------------------------------- |
| **Base**      | The base containing the table   |
| **Table**     | The table containing the record |
| **Record ID** | The ID of the record to delete  |

**Output variables**

| Variable      | Description                                 |
| ------------- | ------------------------------------------- |
| **Record ID** | The unique identifier of the deleted record |

***

### Add attachment

Uploads a file to an attachment field on an existing record. Use this to attach AI-generated documents, processed files, or outputs from earlier steps directly to an Airtable record.

**Configuration**

| Field         | Description                                                         |
| ------------- | ------------------------------------------------------------------- |
| **Base**      | The base containing the table                                       |
| **Table**     | The table containing the record                                     |
| **Record ID** | The ID of the record to attach the file to                          |
| **Field**     | The attachment field to add the file to                             |
| **File**      | The file to attach — reference a file variable from a previous step |

**Output variables**

| Variable         | Description                                 |
| ---------------- | ------------------------------------------- |
| **Record ID**    | The unique identifier of the updated record |
| **Created Time** | Timestamp when the record was last modified |

## Next steps

<CardGroup cols={2}>
  <Card title="Workflows overview" icon="diagram-project" href="/workflows/overview">
    Learn how to build and run Workflows in Cassidy.
  </Card>

  <Card title="Airtable Agent Connector" icon="robot" href="/integrations/airtable/agent-connector">
    Let Agents read and write Airtable records during conversations.
  </Card>
</CardGroup>
