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

# XblMultiplayerSendInvitesAsync

> XblMultiplayerSendInvitesAsync

# XblMultiplayerSendInvitesAsync

Invites the specified users to a session. This will result in a notification being shown to each invited user using standard invite text. If a user accepts that notification the title will be activated.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerSendInvitesAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerSessionReference* sessionReference,  
         const uint64_t* xuids,  
         size_t xuidsCount,  
         uint32_t titleId,  
         const char* contextStringId,  
         const char* customActivationContext,  
         XAsyncBlock* async  
)  
```

### Parameters

*xblContext*   \_In\_\
Type: [XblContextHandle](/reference/live/xsapi-c/types_c/handles/xblcontexthandle)

XBOX live context for the local user.

*sessionReference*   \_In\_\
Type: [XblMultiplayerSessionReference\*](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

An XblMultiplayerSessionReference object representing the session the target users will be invited to.

*xuids*   \_In\_\
Type: uint64\_t\*

The list of xbox user IDs who will be invited.

*xuidsCount*   \_In\_\
Type: size\_t

Size of the xuids array.

*titleId*   \_In\_\
Type: uint32\_t

The ID of the title that the invited user will activate in order to join the session.

*contextStringId*   \_In\_opt\_z\_\
Type: char\*

The custom context string ID. This string ID is defined during XBOX Live ingestion to identify the invitation text that is additional to the standard invitation text. The ID string must be prefixed with " /// ". Pass nullptr if you don't want a custom string added to the invite.

*customActivationContext*   \_In\_opt\_z\_\
Type: char\*

The activation context string. A game defined string that is passed to the invited game client and interpreted as desired. (Optional)

*async*   \_In\_\
Type: XAsyncBlock\*

The AsyncBlock for this operation.

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Requirements

**Header:** multiplayer\_c.h

**Library:** Microsoft.Xbox.Services.14x.GDK.C.lib

## Conceptual documentation

* [Sending invites](/services/xbox-services/multiplayer/invites/how-to/live-invites-send)

## See also

[multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [Sending invites](/services/xbox-services/multiplayer/invites/how-to/live-invites-send.md)
- [Multiplayer Session Directory overview](/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [Moving from MPSD to PlayFab Multiplayer and MPA](/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)
- [Multiplayer tasks](/services/xbox-services/multiplayer/mpsd/how-to/live-mpsd-how-tos.md)
- [Best practices for calling XBOX services](/services/xbox-services/develop/best-practices/live-best-practices-calling-xbl.md)