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

# Connect Airtable

> Connect your Airtable so your agent can query your tables and log what happened in the conversation.

Airtable is for teams that already built their operation there: inventory, orders, requests, whatever it is. Connecting it lets your agent query those records during the call and answer with the real figure.

And write: log the request, the order or the lead with what it gathered, in the table you already use.

## What you need first

* An **Airtable** account with access to the base you want to use.
* The base and the table already created. During the authorization you pick which bases to grant access to, so know which ones.
* The **Starter** plan or higher in Ryvo, with the Engine module active.

## How to connect it

<Steps>
  <Step title="Open Settings › Integrations">
    In the portal, go to **Settings** and then **Integrations**. Find the **Airtable** card.
  </Step>

  <Step title="Click Connect app">
    Airtable's authorization screen opens in a new window. Meanwhile the card shows **In progress**.
  </Step>

  <Step title="Pick which bases to grant access to">
    Airtable asks you to tick the bases you want to share. Anything you leave unticked, your agent cannot see.
  </Step>

  <Step title="Come back to Ryvo">
    You land back on the Integrations screen on your own and the card turns to **Connected**. Airtable asks nothing else inside Ryvo.
  </Step>
</Steps>

## What your agent can do once it is connected

| Action            | What it does in the conversation                            |
| ----------------- | ----------------------------------------------------------- |
| **Find records**  | Queries a table's records so it answers with real data.     |
| **Create record** | Creates a record with what it gathered in the conversation. |
| **Update record** | Updates a record it already located with the search.        |

Actions are turned on one by one from **View actions** and the [**Tools**](/guides/agents/tools) section of the builder, with a cap of **10 integration actions per agent**.

<Note>
  Tell your agent **which base and which table** to work on, in its instructions inside the builder. Without that it has to guess among everything you shared.
</Note>

## What to do if something fails

| What you see                                          | What happened                                                                            | What to do                                                                                          |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| The agent says it cannot find the base or the table   | You did not tick it during the authorization, or the table was renamed                   | Click **Reconnect** and tick the base. If only the name changed, fix it in the agent's instructions |
| **Create record** fails                               | The table fields do not match what the agent is sending, or a required one arrives empty | Check the table's required fields and mention them in the agent's instructions                      |
| **The account stopped responding. Connect it again.** | You revoked access from Airtable, or the integration token expired                       | Click **Reconnect**: Ryvo revokes the old access and opens the authorization from scratch           |