Articles on: Onboarding

πŸ”’ Airtable Personal Access Token

To sync your Shopify store with Airtable using SyncBase, we need access to your Airtable account. This requires two key elements: your Workspace ID and a Personal Access Token.


How does the Airtable Personal Access Token work?


A Personal Access Token is a secure key that allows third-party apps like SyncBase to interact with your Airtable account. This includes tasks like creating bases, pushing data, updating records, and more.


The token is defined by two components:

  • Scopes – what actions the app is allowed to perform (e.g., read, write, delete).
  • Access – which environments (workspaces and bases) the scopes apply to.


Why do we need full Access & Scopes


When you connect SyncBase to Airtable, we need full access to:

  • Generate the base: create a new Airtable base or use an existing one to receive your store data.
  • Manage records: continuously create, update, and delete records during synchronization.

Without these permissions, SyncBase can’t perform the sync operations properly.


Your Airtable Token is tied to an account, not a base


It's important to understand that a Personal Access Token is linked to the Airtable account that created it, not to a specific base.

This means that if the user who generated the token is later removed from the base or workspace, SyncBase will no longer be able to access or sync data, and synchronization will stop working.

That’s why we recommend using a token from an account that will remain active and maintain access to the synced base.


How to restrict access after base generation


After your base has been successfully generated and the sync is up and running, you can limit access to only the specific base used by SyncBase.


Once access is restricted to a single base, SyncBase will no longer have visibility into any other workspaces or bases in your Airtable account.


Step by step


  1. Go to your Airtable Personal Access Tokens and find the one you’re using with SyncBase.
  2. Edit the token permissions:
    • Remove access to ALL RESSOURCES (also named All current and future bases in all current and future workspaces, and HyperDB tables)
    • Grant access only to the synced base:
    • If SyncBase created a new base: look for Shopify Shop
    • If you used your own base: select the base you connected (e.g., YourBaseName)
  1. Click on the Save changes button.




Updated on: 03/06/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!