Airtable Setup Guide

Prerequisites

• An active Airtable account
• A Personal Access Token

Setup Guide

Step 1: Retrieve Your Airtable API Key (Personal Access Token)

1. Go to the Airtable Developer Hub

2. From /create/tokens, click the “Create new token” button to create a new personal access token.

3. In the “Token name” field, enter a descriptive name like Matia-Token.

4. Under “Scopes”, select the following:

   • data.records:read
   • data.recordComments:read (optional, if you want to sync comments)
   • schema.bases:read

5. Under "Access to Workspaces", choose one of:

   1. Allow access to all current and future bases, or
   2. Manually select specific bases to limit scope

6. Click Create token

7. Copy the generated Personal Access Token (PAT) and store it securely. You will not be able to view it again once you close the dialog.

Step 2: Complete Configuration in Matia

1. Paste the Personal Access Token you generated.
2. Enter an Asset Name.
3. (Optional) Enter a Description.
4. (Optional) Assign Tags.
5. Select an Owner.
6. Verify that your Airtable account is successfully connected by clicking on Test Connection.
7. Click Connect.

Note on Table Changes in Airtable

Airtable does not track table name changes or deletions through its API. As a result:

• If you rename a table after it has already been synced, Matia will no longer recognize it. To resume syncing, you must refresh the Airtable assets’s source schema in Matia (in the integration schema tab). The renamed table will then appear as a new stream under its updated name.
• If you delete a table from Airtable after it has been synced, the integration will simply stop attempting to sync it. No new data will be ingested from that table, but existing data in your destination will remain untouched.