Airtable

How it works#

The Airtable connector indexes records from your Airtable bases. Each record becomes a searchable document in Nexus, with field names and values preserved.

You can choose to index all bases and tables accessible by your API token, or a specific table by pasting its URL.

Table updates are pulled every 24 hours by default.

Setting up#

1. Create a Personal Access Token#

Open the Builder Hub#

In Airtable, click on your profile icon in the top-right corner and select Builder Hub.

Go to Personal Access Tokens#

In the Builder Hub sidebar, click Personal access tokens, then click Create new token.

Configure scopes#

Give your token a name (e.g. "Nexus") and add the following scopes:

• data.records:read. read record data

• data.recordComments:read. read record comments

• schema.bases:read. read base and table schemas

• user.email:read. read user email addresses (for collaborator fields)

Grant access to your bases#

Under Access, grant the token access to all the bases you want indexed in Nexus.

If you plan to use the Everything option, make sure the token has access to every base you want included.

Create and copy the token#

Click Create token and copy it. You won't be able to see it again.

2. Add the connector in Nexus#

Open the Airtable connector#

Navigate to the Admin Panel and select the Airtable connector.

Create a credential#

Create a new credential and paste your Personal Access Token.

Choose what to index#

You have two options:

Everything. Automatically discovers and indexes all bases and tables that your token has access to. No additional configuration needed.

Specific Table. Indexes a single table. To use this option:

• Open the table you want in Airtable in your browser.

• Copy the URL from the address bar (it looks like https://airtable.com/appXXX/tblYYY/viwZZZ).

• Paste it into the Airtable URL field.

The base ID, table ID, and view ID are automatically extracted from the URL.

Advanced options#

• Treat all fields except attachments as metadata. When enabled, text fields (like "Title" or "Description") are stored as metadata key-value pairs instead of searchable document content. Only attachment file contents become the searchable body of the document. Use this when the primary content you care about is in file attachments, and the other columns are just labels or categories.

• Share ID (Specific Table only). If you want record links in Nexus to use a shared view URL, enter the share ID here (e.g. shrkfjEzDmLaDtK83). You can find this by creating a shared view in Airtable.

Before using this source with students#

Start with approved course material. Check which documents the connector can retrieve and how it maps source permissions. Test with a student account and a teacher account before widening access. A successful sync does not prove that the intended class boundary is correct.

Use source troubleshooting when a document is missing or visible to the wrong audience.