Skip to content
Dashboard
Theme
Theme

Social sign-in

Sign in with Google, GitHub, Microsoft and other providers, with your own OAuth clients and a safe account-linking rule.

View Markdown

Social sign-in supports seven providers: google, microsoft, github, apple, gitlab, linkedin and slack. Google and GitHub are on every plan; the others need Pro or above. Configure each one with your own OAuth client:

  • GET /v1/user_management/social_providers lists them.
  • PUT /v1/user_management/social_providers/{provider} sets client_id, client_secret and enabled. The secret is encrypted at rest and never returned. For Apple, the secret is the client-secret JWT you generate from your Sign in with Apple key.
  • DELETE /v1/user_management/social_providers/{provider} removes one.

Turn the social method on in PUT /v1/user_management/settings.

The environment’s linking_rule decides what happens when a social account’s email matches an existing user:

  • verified_email (default): link only when the provider asserts the email is verified.
  • never: never link automatically.

An unverified email never matches an existing user, and providers that do not assert verification never link automatically. GET /v1/users/{user}/identities lists a user’s linked accounts. A failed provider sign-in returns user_social_sign_in_failed; a refused link returns user_link_refused.