Auth

Start SSO

Initiate a new Single Sign-On (SSO) session. Returns a session URL to be completed with SSO provider credentials.

post/auth/sso/start

Request body

redirect_tostring nullable

URL to redirect to after SSO completion

redirect_uristring nullable

OAuth redirect URI to use for the SSO provider callback

Response

Success

authorization_urlstring required

URL to redirect user to for SSO authentication

statestring required

State parameter for CSRF protection

redirect_uristring required

OAuth redirect URI used for the SSO provider callback

Changes

Changed in 4 of the 21 revisions of this API.216114

Sep 18, 2026dd0ad4ea1c8822See the full diff
- ▲
  request property list-of-types was narrowed by removing types null from media type application/json
  request-property-list-of-types-narrowed
- ▲
  request property list-of-types was narrowed by removing types null from media type application/json
  request-property-list-of-types-narrowed
- ○
  the request property became nullable
  request-property-became-nullable
- ○
  the request property became nullable
  request-property-became-nullable
Sep 6, 2026a52a2cf49d9b16100See the full diff
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new IP_BAN_DECLINED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_COUNTRY_NOT_SUPPORTED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_GATE_ESCAPE_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_INBOUND_VERIFICATION_REQUIRED enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_LOOKUP_UNAVAILABLE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_IN_SERVICE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_NUMBER_NOT_MOBILE enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new PHONE_VERIFICATION_NEEDS_REVIEW enum value to the response property for the response status
  response-property-enum-value-added
- ○
  removed the ACCOUNT_DISABLED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ACCOUNT_DISABLED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ACCOUNT_SCHEDULED_FOR_DELETION enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ACCOUNT_SCHEDULED_FOR_DELETION enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the AGE_VERIFICATION_INVALID_CARD_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the AGE_VERIFICATION_INVALID_CARD_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the APPLICATION_NOT_FOUND enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the APPLICATION_NOT_FOUND enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the AUDIT_LOG_INDEXING enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the AUDIT_LOG_INDEXING enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the BLUESKY_OAUTH_SESSION_EXPIRED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the BLUESKY_OAUTH_SESSION_EXPIRED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the BOT_APPLICATION_NOT_FOUND enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the BOT_APPLICATION_NOT_FOUND enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the CANNOT_MODIFY_VOICE_STATE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the CANNOT_MODIFY_VOICE_STATE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the CHANNEL_INDEXING enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the CHANNEL_INDEXING enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the CONNECTION_INVALID_IDENTIFIER enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the CONNECTION_INVALID_IDENTIFIER enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the CREATION_FAILED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the CREATION_FAILED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the DECRYPTION_FAILED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the DECRYPTION_FAILED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the DISCOVERY_DESCRIPTION_REQUIRED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the DISCOVERY_DESCRIPTION_REQUIRED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the DISCOVERY_INVALID_CATEGORY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the DISCOVERY_INVALID_CATEGORY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the DONOR_NOT_FOUND enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the DONOR_NOT_FOUND enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the EMPTY_ENCRYPTED_BODY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the EMPTY_ENCRYPTED_BODY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ENCRYPTION_FAILED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the ENCRYPTION_FAILED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the EU_WITHDRAWAL_WAIVER_REQUIRED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the EU_WITHDRAWAL_WAIVER_REQUIRED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the GUILD_TEMPLATE_FETCH_FAILED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the GUILD_TEMPLATE_FETCH_FAILED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the HTTP_GET_AUTHORIZE_NOT_SUPPORTED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the HTTP_GET_AUTHORIZE_NOT_SUPPORTED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INSTANCE_VERSION_MISMATCH enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INSTANCE_VERSION_MISMATCH enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_CLIENT enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_CLIENT enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_CLIENT_SECRET enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_CLIENT_SECRET enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_DECRYPTED_JSON enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_DECRYPTED_JSON enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_EPHEMERAL_KEY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_EPHEMERAL_KEY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_GRANT enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_GRANT enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_IV enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_IV enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_REDIRECT_URI enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_REDIRECT_URI enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RESPONSE_TYPE_FOR_NON_BOT enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_RESPONSE_TYPE_FOR_NON_BOT enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_SCOPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_SCOPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_SUDO_TOKEN enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_SUDO_TOKEN enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the IP_BANNED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the IP_BANNED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_ANIMATED_EMOJIS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_ANIMATED_EMOJIS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PINS_PER_CHANNEL enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PINS_PER_CHANNEL enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_WEBHOOKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_WEBHOOKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MESSAGE_TOTAL_ATTACHMENT_SIZE_TOO_LARGE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MESSAGE_TOTAL_ATTACHMENT_SIZE_TOO_LARGE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MISSING_CLIENT_SECRET enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MISSING_CLIENT_SECRET enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MISSING_EPHEMERAL_KEY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MISSING_EPHEMERAL_KEY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MISSING_IV enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MISSING_IV enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MISSING_OAUTH_FIELDS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MISSING_OAUTH_FIELDS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MISSING_REDIRECT_URI enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MISSING_REDIRECT_URI enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NEW_ACCOUNT_GUILD_JOIN_RATE_LIMITED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NEW_ACCOUNT_GUILD_JOIN_RATE_LIMITED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NOT_OWNER_OF_ADMIN_API_KEY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NOT_OWNER_OF_ADMIN_API_KEY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NO_VISIONARY_SLOTS_AVAILABLE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NO_VISIONARY_SLOTS_AVAILABLE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PASSKEYS_DISABLED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PASSKEYS_DISABLED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the REDIRECT_URI_REQUIRED_FOR_NON_BOT enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the REDIRECT_URI_REQUIRED_FOR_NON_BOT enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the STREAM_THUMBNAIL_PAYLOAD_EMPTY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the STREAM_THUMBNAIL_PAYLOAD_EMPTY enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the STRIPE_SUBSCRIPTION_PERIOD_END_MISSING enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the STRIPE_SUBSCRIPTION_PERIOD_END_MISSING enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNFURL_STREAM_TOO_LARGE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNFURL_STREAM_TOO_LARGE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNSUPPORTED_RESPONSE_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNSUPPORTED_RESPONSE_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
This revision's changelog hit the recording limit, so it may not list every change to this endpoint.
Sep 5, 20264dbb738a3e222See the full diff
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the NSFW_EMOJI_STICKER_BLOCKED enum value from the response property for the response status
  response-property-enum-value-removed
Sep 3, 2026fa36b1b48ca510See the full diff
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the INVALID_PACK_TYPE enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACKS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the MAX_PACK_EXPRESSIONS enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the PACK_ACCESS_DENIED enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the UNKNOWN_PACK enum value from the response property for the response status
  response-property-enum-value-removed
This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 21 revisions, 2 have no diff computed.

Full history