Become a 10x Brand Engineer with Cuppa AI See Who's Hiring ↗
IntegrationsAirtable

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
  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 FieldRecommended Airtable Column Type
TitleSingle line text
ContentLong text
SlugSingle line text
ExcerptLong text
Target KeywordSingle line text
KeywordsLong text
LanguageSingle line text
Image URLURL
DateDate

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 FieldDescription
titleArticle title
slugURL-friendly version of the title
contentFull HTML content of the article
excerptShort summary/description
target_keywordPrimary keyword the article targets
keywordsAll keywords (comma-separated)
languageContent language (e.g., “en-US”)
imageFeatured image URL
dateArticle 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?

ContentfulShopify