# Airtable

## Airtable Integration

Connect Cuppa to Airtable to automatically export your AI-generated content to your Airtable bases. This is perfect for teams who use Airtable as a content management or workflow tool.

### What You Can Do

* **Export projects** to Airtable with one click
* **Map your fields** to match your Airtable table structure
* **Clear & replace** content in your table before each export (optional)
* **Bulk export** thousands of articles efficiently

***

### Prerequisites

Before connecting, you'll need:

1. An **Airtable account** (free or paid)
2. A **Personal Access Token** from Airtable
3. A **Base** and **Table** set up in Airtable to receive your content

***

### Step 1: Create Your Airtable Personal Access Token

1. Go to [airtable.com/create/tokens](https://airtable.com/create/tokens)
2. Click **"Create new token"**
3. Give it a name (e.g., "Cuppa Integration")
4. Under **Scopes**, select:
   * `data.records:read`
   * `data.records:write`
5. Under **Access**, select the specific base(s) you want Cuppa to access
6. Click **"Create token"**
7. **Copy the token** — you won't see it again!

> 💡 **Tip**: Only grant access to the bases you need. This keeps your data secure.

***

### Step 2: Get Your Base ID and Table ID

#### Find Your Base ID

1. Open your Airtable base
2. Look at the URL: `https://airtable.com/appXXXXXXXXXXX/...`
3. The Base ID starts with `app` (e.g., `appABC123xyz`)

#### Find Your Table ID

1. Click on the table you want to use
2. Look at the URL: `https://airtable.com/appXXX/tblYYYYYYYYYYY/...`
3. The Table ID starts with `tbl` (e.g., `tblDEF456abc`)

> 💡 **Tip**: You can also use the table name instead of the Table ID.

***

### Step 3: Set Up Your Airtable Table

Create columns in your Airtable table to receive your content. Here are the fields Cuppa can export:

| Cuppa Field    | Recommended Airtable Column Type |
| -------------- | -------------------------------- |
| Title          | Single line text                 |
| Content        | Long text                        |
| Slug           | Single line text                 |
| Excerpt        | Long text                        |
| Target Keyword | Single line text                 |
| Keywords       | Long text                        |
| Language       | Single line text                 |
| Image URL      | URL                              |
| Date           | Date                             |

You can name your Airtable columns anything you want — you'll map them in the next step.

***

### Step 4: Connect Airtable in Cuppa

1. Go to **Team Settings** → **Integrations**
2. Find **Airtable** and click **Connect**
3. Enter your:
   * **Personal Access Token**
   * **Base ID** (starts with `app`)
   * **Table ID** or table name
4. **Map your fields**: Tell Cuppa which Airtable columns should receive each field
5. (Optional) Enable **"Clear table before export"** if you want to replace all content each time
6. Click **Save**

***

### Step 5: Export Content to Airtable

#### Export a Single Project

1. Open any project in Cuppa
2. Click the **"Export"** button
3. Select **"Export to Airtable"**
4. Choose which articles to export
5. Click **Export**

#### Bulk Export

For large exports (hundreds or thousands of articles), Cuppa automatically:

* Batches your records (10 at a time)
* Handles Airtable's rate limits
* Shows you progress as it exports

***

### Field Mapping Reference

When setting up your integration, you map Cuppa fields to your Airtable columns:

| Cuppa Field      | Description                         |
| ---------------- | ----------------------------------- |
| `title`          | Article title                       |
| `slug`           | URL-friendly version of the title   |
| `content`        | Full HTML content of the article    |
| `excerpt`        | Short summary/description           |
| `target_keyword` | Primary keyword the article targets |
| `keywords`       | All keywords (comma-separated)      |
| `language`       | Content language (e.g., "en-US")    |
| `image`          | Featured image URL                  |
| `date`           | Article creation date               |

***

### Troubleshooting

#### "Connection failed" error

* Double-check your Personal Access Token is correct
* Ensure the token has access to the base you're trying to use
* Verify your Base ID starts with `app`

#### "Table not found" error

* Check that the Table ID is correct (starts with `tbl`) or the table name matches exactly
* Ensure your token has access to this specific base

#### Fields not appearing in Airtable

* Make sure you've mapped the fields in Cuppa's integration settings
* Check that the column names in your mapping match your Airtable columns exactly

#### Rate limit errors

* For very large exports, wait a few minutes and try again
* Cuppa automatically handles rate limiting, but extremely large batches may need to be split

***

### FAQ

**Can I export to multiple Airtable bases?** Currently, each Cuppa team can connect to one Airtable base. If you need multiple bases, you can update your integration settings between exports.

**Does it update existing records or create new ones?** Cuppa creates new records each time. If you enable "Clear table before export," it will delete existing records first.

**What happens if the export fails partway through?** Your exported records stay in Airtable. You can see the progress and any errors in the export status.

**Can I schedule automatic exports?** Not yet, but you can use Cuppa's webhook feature to trigger exports when content is ready.

***

### Need Help?

* Check our [Help Center](https://learn.cuppa.ai)
* Contact support at <support@cuppa.ai>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.cuppa.ai/integrations/airtable.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.