Skip to main content
Sanity provisions OAuth client credentials manually and does not support refresh tokens. Choose a long access-token validity when requesting credentials, since StackOne cannot silently renew an expired token — the user must re-authorize.

Request OAuth client credentials from Sanity

Sanity does not offer self-service OAuth app registration. You must contact Sanity to have your application credentials (Client ID and Client Secret) provisioned manually.

1

Contact Sanity to set up your OAuth application

Reach out to your Sanity customer representative or via sanity.io/contact/sales. Provide the details Sanity needs to register your app.

  • Application name and a short description (shown on the authorization page)
  • Application image URL (shown on the authorization page)
  • Callback URL: copy it from your Connector Profile
  • Access token validity duration — request a non-expiring (or the longest possible) token validity for your OAuth app. Sanity does not issue refresh tokens, so an expired token cannot be renewed automatically and the connection must be re-authorized.
  • Important: explicitly ask Sanity to set your OAuth app’s access tokens to never expire (no expiry). Because there are no refresh tokens, a non-expiring token is what keeps the connection working without periodic re-authorization.
2

Receive your Client ID and Client Secret

Sanity will return your application’s credentials.

  • Store the Client ID and Client Secret securely for use when creating the Connector Profile in StackOne

Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.