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

Open the connector

Log in to StackOne, open Connectors, and select Sanity.
2

Choose actions and events

  • Click Add Profile.
  • If the connector offers more than one authentication method, set the Auth Method filter to OAuth 2.0.
  • Select the actions, and any events, to enable for this Connector Profile.
  • Click Continue.
3

Set up authentication

  • Select Authentication Type as OAuth 2.0.
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
  • Click Create Profile.
Congratulations! The new Connector Profile now shows up on the connector page. If you created it as a project member rather than an admin, it starts disabled until a project admin enables it. You can now continue to Link Accounts for Sanity.