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: https://api.stackone.com/connect/oauth2/sanity/callback
  • 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

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Sanity:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Sanity
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Sanity.