n8n-docs/docs/integrations/builtin/credentials/airtable.md

3.4 KiB

title description contentType
Airtable credentials Documentation for Airtable credentials. Use these credentials to authenticate Airtable in n8n, a workflow automation platform. integration

Airtable credentials

You can use these credentials to authenticate the following nodes:

Prerequisites

Create an Airtable{:target=_blank .external-link} account.

Supported authentication methods

  • Personal Access Token (PAT)
  • OAuth2

/// note | API Key deprecation n8n previously supported an API key authentication method with Airtable. Airtable fully deprecated these keys{:target=_blank .external-link} as of February 2024. If you were using an Airtable API credential, replace it with an Airtable Personal Access Token or Airtable OAuth2 credential. n8n recommends using Personal Access Token instead. ///

Refer to Airtable's API documentation{:target=_blank .external-link} for more information about the service.

Using personal access token

To configure this credential, you'll need:

  • A Personal Access Token: Follow the instructions to Find/create PATs in the Airtable documentation{:target=_blank .external-link} to get a Personal Access Token (PAT).

n8n recommends using the following Scopes for your PAT:

  • data.records:read
  • data.records:write
  • schema.bases:read

Using OAuth2

To configure this credential, you'll need:

  • An OAuth Redirect URL
  • A Client ID
  • A Client Secret

Refer to the Airtable Register a new integration documentation{:target=_blank .external-link} for steps on registering a new Oauth integration.

  1. Open your Airtable Developer Hub to OAuth integrations{:target=_blank .external-link}.
  2. Select the Register new OAuth integration button.
  3. Provide a name for your OAuth integration.
  4. In the n8n Airtable OAuth2 credentials dialog, copy the OAuth Redirect URL.
  5. In Airtable, paste that redirect URL into the OAuth redirect URL.
  6. Then select the Register integration button in Airtable.
  7. On the following page, copy the Client ID from Airtable and paste it into the Client ID parameter in the n8n Airtable OAuth2 credentials dialog.
  8. In Airtable, select the Generate client secret button.
  9. Copy the client secret and paste it into the Client Secret parameter in the n8n Airtable OAuth2 credentials dialog.
  10. Select the following scopes in Airtable:
    • data.records:read
    • data.records:write
    • schema.bases:read
  11. Select Save changes at the bottom of the page in Airtable.
  12. In the n8n Airtable OAuth2 credentials dialog, select the Connect my account button.
  13. This will open a Grant access dialog. Follow the instructions in the dialog and select the base you want to work on (or all bases).
  14. Select the Grant access button in the dialog to complete the connection.