Try or ByeTry or Bye

Airtable API 401, 403 and 422 Errors

Share
Workaround available Web, API Updated November 13, 2026Based on 2 user reportsHow we research

Quick answer

Most Airtable API errors come from tokens: 401 means a missing or wrong token, 403 means missing scopes or base access, 422 means a bad request body or unknown field or option.

Most likely fix: Fix 401 Unauthorized

How to fix it

Try these in order — the most common fix is first.

  1. 1. Fix 401 Unauthorized

    1. Send the token in the Authorization header as Bearer, not Basic
    2. Send the full personal access token (two parts separated by a period); if you lost the secret, regenerate the token
    Did this fix it?

  2. 2. Fix 403 Forbidden

    1. Confirm the token has the needed scopes and is granted access to the base, and that your user is a base collaborator
    2. Try the same change in the Airtable UI to find a field or table with restricted editing
    3. Writes fail for Viewer (Restricted) licenses; an admin must upgrade the license to Editor or higher
    4. Reproduce with curl or Postman to read error.message, because integration tools often hide it
    Did this fix it?

  3. 3. Fix 422 Invalid Request

    1. Send valid JSON with the Content-Type: application/json header on POST, PUT and PATCH
    2. For invalid_multiple_choice_options, match an existing option or enable typecast
    3. If you see UNKNOWN_FIELD_NAME, look up the current field ID, since recreating a field changes it
    Did this fix it?

Symptoms

API requests return 401 Unauthorized, 403 Forbidden (invalid_permissions) or 422 Invalid Request.

Why it happens

  • Token not sent as Bearer or only the short token ID was sent
  • Token lacks the right scopes or base access, or your user is not a collaborator on the base
  • Field- or table-level editing permissions, or a Viewer (Restricted) license blocking writes
  • Malformed JSON, missing Content-Type header, select option that does not exist, or a recreated field with a new ID

This guide also covers

  • airtable api 403 forbidden
  • airtable 422 error
  • airtable api 401 unauthorized

Still not working?

If Airtable keeps failing, you're not alone. See every Airtable problem users report or the alternatives people switch to.

Done fighting Airtable? Our small team builds your own Airtable alternative, made for how you work. On your domain or hosted by us. Price agreed together.

Get a quote
Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Airtable errors