Skip to main content

​
About Airtable

The Airtable integration manages licenses in an Airtable enterprise account. People request Airtable access in Serval like any other application. When a request is approved, Serval activates their Airtable account. When access is removed, Serval deactivates the account so it stops counting toward your billable seats. Workflows can also list everyone who holds an active Airtable license, with their license type and the last time they used Airtable, so you can find and reclaim unused licenses. Authentication: An Airtable personal access token owned by an enterprise admin, and your enterprise account ID. Serval stores the token securely and sends it only to api.airtable.com and to Airtable’s SCIM API at airtable.com/scim/v2. Data sync: On demand. Serval reads from Airtable when a workflow or provisioning step runs and does not run a background sync.
The enterprise endpoints this integration uses require an Airtable Enterprise Scale plan. Creating users who are not yet in your enterprise also requires SSO, because it goes through Airtable’s SCIM API.

​
Create a personal access token

Serval acts as the enterprise admin who owns the token. We recommend a dedicated service account with admin rights in your enterprise account.
1

Sign in as an enterprise admin

Sign in to Airtable as the admin Serval will act as.
2

Open the token builder

Go to airtable.com/create/tokens and select Create new token.
3

Add scopes

Add these scopes:
4

Create the token

Create the token and copy it. Airtable shows it only once.
Find your enterprise account ID in the Airtable admin panel. It starts with ent.

​
Connect in Serval

1

Enter your details

Enter the enterprise account ID and paste the personal access token, then submit the form.

​
Verify the connection

Serval checks that the token is valid, that it can read your enterprise account, and that it can read enterprise users. A failed check usually means one of three things: the token was revoked, the enterprise account ID is wrong, or the token’s owner is not an enterprise admin or lacks a scope listed above.

​
License provisioning

Connecting Airtable creates a User role for the app. Requests for this role are fulfilled automatically:
  • Granting access activates the user’s Airtable account if it was deactivated. If the user is not in your enterprise yet, Serval creates them through SCIM using their email and name. This requires the SCIM scope and SSO. Without them, invite the user in Airtable instead.
  • Removing access deactivates the user. They can no longer sign in and do not count toward billable seats. Their workspaces, bases and collaborators are kept, and granting access again reactivates them. Deprovisioning also runs when access is removed by an access review or a license reclamation.
Airtable only lets admins activate or deactivate users it manages: users whose email is on a domain your enterprise has claimed. For collaborators from other domains, Serval reports an error and you remove them from the enterprise in the Airtable admin panel.

​
Included workflows

Airtable allows 50 API requests per second per token and blocks the token for 30 seconds after it exceeds the limit. Serval waits and retries when that happens.
Need help? Contact support@serval.com for assistance with your Airtable integration.