Skip to content
threada Docs

Start social sign-in

Service: threada.bff.v1.BffPublicService Method: StartSocialSignIn Path: /threada.bff.v1.BffPublicService/StartSocialSignIn

Request

StartSocialSignInRequest

FieldTypeNotes
providerstringIdentity provider id (e.g., “google”, “apple”).
nextstringPost-login redirect path within the shell.
return_tostringAbsolute return URL, validated against the tenant’s origin allowlist.
langstringBCP-47 language tag for the consent screen.
intentSocialSignInIntentExplicit browser intent. Unspecified is treated as sign-in and cannot provision an account.
planstringOptional self-serve plan context. The BFF allowlists and canonicalizes this value.

Response

StartSocialSignInResponse

FieldTypeNotes
auth_urlstringProvider authorization URL the client should redirect to.
session_idstringShort-lived state token bound to this sign-in attempt. Required when completing.