Social sign-in
Sign in with Google, GitHub, Microsoft and other providers, with your own OAuth clients and a safe account-linking rule.
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 /lists them.v1/ user_management/ social_providers PUT /setsv1/ user_management/ social_providers/ {provider} client_id,client_secretandenabled. 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 /removes one.v1/ user_management/ social_providers/ {provider}
Turn the social method on in PUT /.
Linking to existing users
Section titled “Linking to existing users”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 / lists a user’s linked accounts. A failed provider sign-in returns user_social_sign_in_failed; a refused link returns user_link_refused.