# Get URL to link social network to account

Gets the URL to link the social network to the user’s account. The social network should be used for authentication.

The linking flow:
1. The user authenticates on the game website.
2. The UI offers to link the social network to the user account.
3. The Xsolla Login server returns social network URL.
4. The game website redirects the user to the social network.
5. The user authenticates in the social network.
6. The Xsolla Login server links the social network to the user account.
7. The Xsolla Login server redirects the user to the game website.

Endpoint: GET /users/me/social_providers/{providerName}/login_url
Version: v1
Security: Bearer

## Path parameters:

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

## Query parameters:

  - `login_url` (string)
    URL to redirect the user to after account confirmation, successful authentication, two-factor authentication configuration, or password reset confirmation. Must be identical to the Callback URL specified in the URL block of Publisher Account. To find it, go to Login > your Login project > General settings. Required if there are several Callback URLs.

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

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

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

## Response 200 fields (application/json):

  - `url` (string, required)
    URL to authenticate the user via the social network.

## Response 403 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.