Company Register Social

Provision a new tenant for a socially-authenticated (OAuth) user.

Email is taken from the verified SuperTokens session; the client supplies the chosen instance name and, optionally, the display name read from the OAuth profile (falls back to the email local-part when absent).

Result of provisioning a tenant for a social (OAuth) signup.

On success, carries a short-lived login_token the client exchanges (via /auth/social/exchange) for the gateway credential — the raw api_key is never returned to the client. When the chosen instance name is taken (or belongs to an instance running its own IdP), status == "instance_taken" and the fields are null so the UI can re-prompt — the two negatives are intentionally indistinguishable so the response can't enumerate SSO instances.