> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-docs-event-stream-action-templates.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Social

> Initiate browser-based login via a social identity provider such as Facebook, Google, or Apple.

## Endpoint

`GET /authorize`

## Social

You can connect your Auth0 service to a social identity provider and allow your users to log in to your application via Facebook, Google, Apple, or other supported providers. To learn more about supported providers, visit [Marketplace](https://marketplace.auth0.com/features/social-connections).

To authenticate users with a social provider, make a `GET` call to the `/authorize` endpoint. It will return a `302` redirect to the social provider specified in the `connection` parameter.

<Note>
  Social connections only support browser-based (passive) authentication because most social providers don't allow a username and password to be entered into applications that they don't own. Therefore, the user will be redirected to the provider's sign in page.
</Note>

### Remarks

* If `response_type=token`, after the user authenticates on the provider, it will redirect to your application `callback URL` passing the Access Token and ID Token in the address `location.hash`. This is used for Single-Page Apps and also on Native Mobile SDKs.

* The sample auth0.js script uses the library version 8. If you are using auth0.js version 7, please see this [reference guide](https://auth0.com/docs/libraries/auth0js).

### Learn More

* [Supported Social Identity Providers](https://marketplace.auth0.com/features/social-connections)
* [Custom Social Connections](https://auth0.com/docs/authenticate/identity-providers/social-identity-providers/oauth2)
* [State Parameter](https://auth0.com/docs/secure/attack-protection/state-parameters)
* [Auth0.js /authorize Method Reference](https://auth0.com/docs/libraries/auth0js#webauth-authorize)

## Query Parameters

<ParamField query="response_type" type="string" required>
  Specifies the token type (code or token)

  Allowed values: `code`, `token`
</ParamField>

<ParamField query="client_id" type="string" required>
  The client\_id of your application
</ParamField>

<ParamField query="connection" type="string">
  The name of a social identity provider configured to your application
</ParamField>

<ParamField query="redirect_uri" type="string" required>
  The URL to which Auth0 will redirect after authorization
</ParamField>

<ParamField query="state" type="string">
  Opaque value to prevent CSRF attacks
</ParamField>

## Response Messages

| Status | Description                              |
| ------ | ---------------------------------------- |
| 302    | Redirect to the social identity provider |
