Skip to content
View as MarkdownOpen in ClaudeOpen in ChatGPT

Authorize Sanity

Create a Sanity API token with the Editor role to connect your Sanity project to Whalesync, and deploy your Studio schema so document types appear.

Whalesync connects to Sanity with an API token (Sanity calls these robot tokens). The token must have the Editor role so Whalesync can create, update, and delete documents.

  1. Open sanity.io/manage and choose your project.
  2. Go to API, then Tokens, and click Add API token.
  3. Name it, for example "Whalesync", and choose the Editor permission.
  4. Copy the token. Sanity shows it only once.
  5. Paste it into the API token box in Whalesync.

If the token can access more than one project, also enter the Project ID. You can find it on the project's page in sanity.io/manage. Most tokens are scoped to a single project, so this box can usually stay empty.