Table of contents
Airtable Setup
WorkSights connects to Airtable using OAuth 2.0. Once connected and bases are selected, Airtable delivers activity to WorkSights in real time. Setup takes a few minutes and works on any paid Airtable plan, Team and above — an Enterprise plan is not required.
For an overview of how Airtable activity appears in WorkSights, see Airtable Integration Overview.
Step-by-Step Setup Instructions
Step 1: Start the Connection
- Go to Settings → Services
- Find Airtable in the list
- Click Connect
Only Admins and Executives in WorkSights can start this connection.
Step 2: Authorize WorkSights in Airtable
WorkSights redirects you to Airtable's own consent screen. Choose which workspaces and bases to grant — "All current and future workspaces" is the simplest option; anything you don't grant here stays invisible to WorkSights. Review the permissions and click Grant access.
Once you approve, WorkSights completes the setup automatically and returns you to the new connection's Bases tab. The connection is named after your email domain (for example "acme.com"), not just "Airtable," because more than one admin can connect to the same shared Airtable service.
Step 3: Choose which bases WorkSights can see
The Bases tab fills in within a minute or two, listing every base you granted, grouped by Airtable workspace, each pre-ticked. Review the list and untick anything sensitive — a base like "Company Layoff Plan" should never reach WorkSights — then click Save bases.
Nothing is watched until you save. That's deliberate: you see the full list of bases before anything is ingested.
Leave Watch new bases automatically on if a new base appearing in a granted workspace should start ticked by default — you can still untick it later. Turn it off if new bases should start unticked and wait for a deliberate decision.
Best practice: the person connecting should be a Creator (or Owner) on the bases that matter. Airtable only lets a Creator or Owner turn on the live change notifications WorkSights relies on — a base where the connecting admin has lower access shows as "Needs an Airtable Creator" until someone with that access connects too, and still gets periodic, limited coverage through a catch-up sweep in the meantime.
Step 4: Review user mapping
Open the Users tab to see Airtable collaborators on your watched bases, matched to WorkSights people by email address. Anyone whose Airtable email doesn't match a WorkSights user needs a matching email address in both systems before their work is attributed on the timeline.
What Happens Next
Once bases are saved, WorkSights begins receiving Airtable changes in real time, and activity starts appearing on the timeline within about 20 minutes of your team's next edit.
No history before the connection is imported — only work from the moment a base starts being watched, forward.
You can return to the Bases tab at any time to add or remove bases, and to the Users tab to check mappings.
Permissions
WorkSights asks Airtable for six scopes when you connect. None of them let WorkSights change your data — it never requests a write scope.
- user.email:read — identifies the Airtable account that connected, and names the connection after its email domain.
- workspacesAndBases:read — lists the bases you granted and groups them by workspace on the Bases tab, and reads base collaborators for the Users tab.
- schema.bases:read — reads table and field names, so a title can say "Stage in Deals" rather than an internal id.
- data.records:read — reads what changed in a record, so a title can name the record and the change.
- data.recordComments:read — reads comments on changed records, credited to their author.
- webhook:manage — sets up, and later removes, Airtable's own change notification on each base you watch. This is the only thing WorkSights creates in Airtable.
Plan Requirements
Airtable works on any paid plan, Team and above. An Enterprise plan is not required — Enterprise would only add visibility into reads and views, which WorkSights doesn't use.