Skip to main content
Keep your token secret — anyone with it has API access at the permission you grant. A token is shown only once at creation; if lost, create a new one. Use a token dedicated to this integration.

​
Find your Project ID

Every call is scoped to your project. After you sign in you land on the organization dashboard, which lists all of your projects.

1

Copy your Project ID

Sign in at sanity.io/manage. From the organization dashboard (which lists all your projects), click your project to open it.

  • From the organization dashboard at sanity.io/manage, click your project to open it
  • No projects yet? Click + New project in the project selector dropdown at the top of the page to create one first
  • Copy the Project ID shown on the project’s overview / settings page (e.g. abc12xyz)
  • Alternatively, read it straight from the browser address bar while inside the project: sanity.io/organizations/<org>/project/<projectId>/... — the value after /project/ is your Project ID

​
Create a project API token

Tokens are created per project under the API tab.

1

Open the project's API > Tokens

Tokens are created per project.

  • In sanity.io/manage, select your project from the organization dashboard to open it
  • Go to the API tab, then Tokens
  • Click Add API token
2

Name the token, set expiration and choose permissions

Permissions are multi-select. To use ALL actions and webhook events in this connector, select Editor, Access Manager, and Blueprints Deployer.

  • Enter a Name (e.g. StackOne Integration) and set Expiration (No expiration for a long-lived integration)
  • Under Permissions > Access level, select Editor — read and write access to all datasets (documents and assets)
  • Expand Other roles and select Access Manager — manage members, invites, roles, permissions, and tags
  • Under Other roles, select Blueprints Deployer — create, update, and delete datasets, update the project, and manage webhooks (required for webhook events)
  • Viewer is not needed once Editor is selected, and Deploy Studio (Token only) is not used by this connector
  • Click Add token
3

Copy the token

The token is shown only once.

  • Copy the token (starts with sk) from the dialog
  • Important: this is your only chance to copy it — store it securely

​
Which permissions to select (by resource / operation)

Each token permission unlocks a different part of this connector. Select the combination that matches the actions you use:

  • Editor — documents (query, get, mutate, export, history) and assets (upload, link), plus read access to datasets, members, roles, and tags
  • Viewer — read-only documents and project reads; use instead of Editor for a read-only connection
  • Access Manager — invites, member role changes and removal, roles and permissions, and tag writes
  • Blueprints Deployer — dataset create/update/delete, project update, and webhook management (required to enable webhook events)
  • Note: a few actions are marked preview and additionally require a Business/Enterprise plan (tag writes, role/permission writes, dataset copy) or a Media Library (link asset), regardless of token permissions.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • API Token
  • Project ID
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account on your Accounts page.

​
Next Steps

Webhooks setup

Configure receiving Events for Sanity into StackOne.