Share via


Account Management - Link PSN Account

Links the PlayStation ™️ Network account associated with the provided access code to the user's PlayFab account

POST https://titleId.playfabapi.com/Server/LinkPSNAccount

Request Header

Name Required Type Description
X-SecretKey True

string

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

Request Body

Name Required Type Description
AuthCode True

string

Authentication code provided by the PlayStation ™️ Network.

PlayFabId True

string

Unique PlayFab assigned ID of the user on whom the operation will be performed.

RedirectUri True

string

Redirect URI supplied to PlayStation ™️ Network when requesting an auth code

CustomTags

object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

ForceLink

boolean

If another user is already linked to the account, unlink the other user and re-link.

IssuerId

number

Id of the PlayStation ™️ Network issuer environment. If null, defaults to production environment.

Responses

Name Type Description
200 OK

LinkPSNAccountResult

400 Bad Request

ApiErrorWrapper

This is the outer wrapper for all responses with errors

Security

X-SecretKey

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

Type: apiKey
In: header

Definitions

Name Description
ApiErrorWrapper

The basic wrapper around every failed API response

LinkPSNAccountRequest
LinkPSNAccountResult

ApiErrorWrapper

The basic wrapper around every failed API response

Name Type Description
code

integer

Numerical HTTP code

error

string

Playfab error code

errorCode

integer

Numerical PlayFab error code

errorDetails

object

Detailed description of individual issues with the request object

errorMessage

string

Description for the PlayFab errorCode

status

string

String HTTP code

LinkPSNAccountRequest

Name Type Description
AuthCode

string

Authentication code provided by the PlayStation ™️ Network.

CustomTags

object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

ForceLink

boolean

If another user is already linked to the account, unlink the other user and re-link.

IssuerId

number

Id of the PlayStation ™️ Network issuer environment. If null, defaults to production environment.

PlayFabId

string

Unique PlayFab assigned ID of the user on whom the operation will be performed.

RedirectUri

string

Redirect URI supplied to PlayStation ™️ Network when requesting an auth code

LinkPSNAccountResult

Error Codes

Name Code
AccountAlreadyLinked 1011
AccountNotFound 1001
InvalidNamespaceMismatch 1561
InvalidPSNAuthCode 1092
InvalidPSNIssuerId 1151
LinkedAccountAlreadyClaimed 1012
PSNInaccessible 1152
RequestViewConstraintParamsNotAllowed 1303

"PlayStation" is a registered trademark or trademark of Sony Interactive Entertainment Inc.