Skip to main content
POST
Link Battle Net Account

Authorizations

X-Authorization
string
header
required

This API requires a client session ticket, available from any Client Login function.

Body

application/json
IdentityToken
string
required

The JSON Web Token (JWT) returned by Battle.net after login

CustomTags
object

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

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

Response

code
integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status
string

The Http status code as a string.

data
object
Last modified on October 1, 2026