# Social sign-in

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`.

## 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 /v1/users/{user}/identities` lists a user's linked accounts. A failed provider sign-in returns [`user_social_sign_in_failed`](/errors/user_social_sign_in_failed/); a refused link returns [`user_link_refused`](/errors/user_link_refused/).
