Airtable

Airtable Integration

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

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

• Contact support at [email protected]