# [OAuth 2.0] Auth via social network

Redirects the user to the page for authentication via the specified social network.

Endpoint: GET /oauth2/social/{provider_name}/login_redirect
Version: v1

## Query parameters:

  - `redirect_uri` (string)
    URL to redirect the user to after account confirmation, successful authentication, or password reset confirmation. To set up this parameter, contact your Customer Success Manager or email to csm@xsolla.com.
Notice The parameter is required if you have more than one redirect URI in your project settings.

  - `client_id` (integer, required)
    Your application ID. Get it after creating an OAuth 2.0 client.

  - `scope` (string)
    Scope is a mechanism in OAuth 2.0 to limit an application’s access to a user’s account.

Can be:
* email for Auth via social network or Get link for social auth calls to request an email from the user additionally.
* offline to use refresh_token from Generate JWT call to refresh the JWT when it is expired.
* playfab to write SessionTicket to the session_ticket claim of the JWT if you store user data at PlayFab.

If you process your own values of the scope parameter, that are not mentioned above, you can set them when using this call. The Xsolla Login server does not process these values, but returns them in the received JWT.

When the email is requested and the social network did not respond with the email value:
* the user will be asked to input an email in the corresponding form if you integrated Login Widget,
* the user must be asked to input an email in the corresponding form of your own interface if you integrated Login API. Please send the URL of this form to your Customer Success Manager.

After the email is inputted, the user receives an email confirmation message. To disable email confirmation, please contact your Customer Success Manager.

  - `state` (string, required)
    Value used for additional user verification. Often used to mitigate CSRF Attacks. The value will be returned in the response. Must be longer than 8 symbols.

  - `response_type` (string, required)
    Grant type used in your project that has the enabled OAuth 2.0 protocol. Must be code to get the user authentication code in the response. The received code must be exchanged to a JWT via the Generate JWT call to finish user authentication.

  - `locale` (string)
    Region in the _ format, where:

* language code: language code in the ISO 639-1 format;
* country code: country/region code in the ISO 3166-1 alpha-2 format.

The list of social networks will be sorted from most to least used, according to the variable value.

  - `phone_only` (boolean)
    Arrange xsolla wallet form behaivior values:
* true show only passwordless by phone,
* false all auth methods.

## Path parameters:

  - `provider_name` (string, required)
    Name of the social network connected to Login in Publisher Account. Can be: amazon, apple, xsolla, baidu, battlenet, discord, epicgames, facebook, github, google,kakao, linkedin, mailru, microsoft, msn, naver, ok, paypal, qq, reddit, steam, twitch, twitter, vimeo,vk, wechat, weibo, xbox, yahoo, yandex, youtube.

If you store user data in PlayFab, only twitch is available.

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)
    Error code.
    Example: "003-061"

  - `error.description` (string, required)
    Error description.
    Example: "Object not found."

  - `error.details` (object)
    Additional information.

## Response 401 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)
    Error code.
    Example: "003-061"

  - `error.description` (string, required)
    Error description.
    Example: "Object not found."

  - `error.details` (object)
    Additional information.

## Response 404 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)
    Error code.
    Example: "003-061"

  - `error.description` (string, required)
    Error description.
    Example: "Object not found."

  - `error.details` (object)
    Additional information.

## Response 422 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)
    Error code.
    Example: "003-061"

  - `error.description` (string, required)
    Error description.
    Example: "Object not found."

  - `error.details` (object)
    Additional information.

## Response 429 fields (application/json):

  - `error` (object, required)

  - `error.code` (string, required)
    Error code.
    Example: "003-061"

  - `error.description` (string, required)
    Error description.
    Example: "Object not found."

  - `error.details` (object)
    Additional information.


## Response 302 fields