Resolve an email address to its account's SSO start URL, if that domain has an active SAML connection. Always 200; `redirect_url` is null when there is nothing to start.
POST
/auth/sso/start
const url = 'https://api.siteqwality.com/auth/sso/start';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"email":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.siteqwality.com/auth/sso/start \ --header 'Content-Type: application/json' \ --data '{ "email": "example" }'Request Body required
Section titled “Request Body required ” Media type application/json
Body for POST /auth/sso/start (public, unauthenticated).
object
email
required
string
Example generated
{ "email": "example"}Responses
Section titled “ Responses ”Redirect URL, or null when the domain has no active SSO connection
Media type application/json
Response for POST /auth/sso/start.
Enumeration-safe by construction: the shape is identical whether or not
the domain has SSO, and the status code is always 200. redirect_url is
null when there is no startable connection, which covers “no such
account”, “account without SSO”, and “SSO configured but not yet active”
with one indistinguishable answer.
object
redirect_url
Stytch SSO start URL to redirect the browser to, or null.
string | null
Example generated
{ "redirect_url": "example"}Invalid email
Rate limited
Internal server error