> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFAccountManagementClientLinkXboxAccountAsync

> Client API to link the XBOX Live account for a provided access token to the authenticated player's PlayFab account for cross-session sign-in.

Links the XBOX Live account associated with the provided access code to the user's PlayFab account

## Syntax

```cpp theme={null}
HRESULT PFAccountManagementClientLinkXboxAccountAsync(  
    PFEntityHandle entityHandle,  
    const PFAccountManagementClientLinkXboxAccountRequest* request,  
    XAsyncBlock* async  
)  
```

### Parameters

**`entityHandle`**   PFEntityHandle

PFEntityHandle to use for authentication.

**`request`**   [PFAccountManagementClientLinkXboxAccountRequest\*](/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementclientlinkxboxaccountrequest)

Populated request object.

**`async`**   XAsyncBlock\*<br />*Inout*

XAsyncBlock for the async operation.

### Return value

Type: HRESULT

Result code for this API operation.

## Remarks

This API is available on Win32, GDK, Linux, and macOS. See also ClientLoginWithXboxAsync, ClientUnlinkXboxAccountAsync. Call XAsyncGetStatus to get the status of the operation. If the service call is unsuccessful, the async result will be E\_PF\_ACCOUNT\_ALREADY\_LINKED, E\_PF\_EXPIRED\_XBOX\_LIVE\_TOKEN, E\_PF\_INVALID\_XBOX\_LIVE\_TOKEN, E\_PF\_LINKED\_ACCOUNT\_ALREADY\_CLAIMED or any of the global PlayFab Service errors. See doc page "Handling PlayFab Errors" for more details on error handling.

## Requirements

**Header:** PFAccountManagement.h

## See also

[PFAccountManagement members](/services/playfab/api-references/c/pfaccountmanagement/pfaccountmanagement_members)