Setup
1
Connect your Airtable account
Click Add Destination, select Airtable, and authorise Redbark. The connection uses OAuth 2.0 with PKCE. You grant access to specific bases, and Redbark requests only the scopes it needs: read and write records, and read and write base schema.
2
Pick a base and table
Choose one of the bases you granted access to, then select an existing table, or click create a Transactions table to have Redbark create a “Redbark Transactions” table for you, with the full transaction field schema already set up.
3
Acknowledge the disclosure and save
Tick the CDR disclosure checkbox confirming you understand data sent to Airtable leaves Redbark’s control and is governed by Airtable’s own terms. Then save the destination.
How it works
On each sync, Redbark Sync:- Ensures the fields exist: when Redbark creates the table for you, it is created with the full transaction field schema already in place. If you pick an existing table instead, only the fields that don’t already exist are added.
- Reads existing Transaction IDs: the
Transaction IDfield is read across the table to identify transactions that have already been synced. - Appends new records: only new posted transactions are written, in batches of up to 10 records per request. Pending transactions are excluded by default. You can enable pending transactions per sync as an experimental setting.
- Applies retroactive corrections: if a previously-synced transaction changes upstream (e.g. a description or category is enriched), the existing record is updated in place rather than duplicated.
typecast enabled, so they coerce into your column types and select options are created automatically — writes succeed even if you change a field’s type.
Transaction fields
If you’ve set up custom categories, two extra fields are added:
If you rename the base or table in Airtable, Redbark detects the new name on the next sync and updates the destination label automatically.
Authentication
Airtable uses OAuth 2.0 with PKCE. Access tokens are short-lived (about an hour) and are refreshed on demand when within 5 minutes of expiry. Airtable rotates the refresh token on every refresh, so Redbark stores the new one each time. If a refresh fails (for example, you revoked Redbark’s access from your Airtable account, or the 60-day refresh token expired through inactivity), the sync is classified asdestination_auth_expired and you’ll be prompted to re-authenticate from the destinations page.
Troubleshooting
Base or table not accessible If Redbark loses access to the base or table (it was deleted, or access was revoked in Airtable), the sync fails and you can reconnect or re-select a table from the destinations page. Rate limits Airtable limits each base to 5 requests per second. Redbark batches writes and automatically backs off and retries on a429, so large syncs complete without intervention.
Tips
- Create the table from Redbark for the quickest start (the full field schema is set up for you immediately).
- Bring your own table if you already have one; Redbark only adds the fields it needs and leaves the rest alone.
- Views and automations are safe: syncs only create and update records, so your views, interfaces, and automations keep working.