Airtable integration

Personal Access Token + URL paste. Maillayer pulls every record on an interval and syncs to contacts.

Setup

  1. Airtable → Account → Developer hub → Personal access tokens → create one. Scope: data.records:read on your base.
  2. Brand → Integrations → Connect Airtable. Paste the PAT (starts with pat…).
  3. Paste any Airtable URL from the table you want to sync — the URL bar in your browser is fine. Maillayer extracts baseId, tableId, and (if present) viewId.
  4. Specify which Airtable column has the email (default: Email). Optionally a name column.
  5. Pick actions, interval, save.

URL extraction

Airtable URLs look like:

https://airtable.com/appXXXXXXXXXXXXXX/tblYYYYYYYYYYYYYY/viwZZZZZZZZZZZZZZ
  • app… = base ID
  • tbl… = table ID
  • viw… = view ID (optional — if you paste a "Share view" URL, Maillayer respects the filter and only syncs rows in that view)

Field name input

Airtable bases differ wildly — there's no fixed convention. The integration asks for two field names:

  • Email field — case-sensitive. Default Email.
  • Name field — optional.

Records whose email field is empty or doesn't look like an email are silently skipped.

Old API keys won't work
Airtable deprecated key… API keys in 2024. Only personal access tokens (pat…) work. If your token is rejected, regenerate it from the Developer hub.