429 Too Many Requests
How you'll know: A backfill or parallel job fails after a burst of calls.
Fix: Each base takes 5 requests a second, and all traffic from one user's tokens shares 50 a second. After a 429 you have to wait 30 seconds. Pace requests below the limit rather than retrying straight away. Airtable's official JavaScript client backs off for you.
Writes are slow and burn calls
How you'll know: Updating 500 records takes 500 requests.
Fix: Create and update endpoints take up to 10 records per request. Batch them, and use performUpsert with fieldsToMergeOn so one call creates new records and updates existing ones by a key field.
An update wiped out other fields
How you'll know: After a sync, fields you never sent are blank.
Fix: You used PUT, which clears every field you leave out. Use PATCH to change only the fields in the request.
Select fields reject new values
How you'll know: A value that isn't already an option fails the write.
Fix: typecast is off by default. Set typecast: true to let Airtable convert strings and add select options, or map values to the existing options before sending.
Webhooks went quiet after a week
How you'll know: Change notifications stopped, though nothing was turned off.
Fix: Webhooks made with a personal access token or OAuth expire after 7 days. Calling refresh, or listing payloads, extends them another 7. Build that refresh into the job.