This API allows a game client to send an invite to an Xbox Live user for a specific title. The invite is sent to all registered endpoints, regardless of platform.
POST /titles/{titleId}/invites
URI parameters
Parameter
In
Required
Type
Description
titleId
path
TRUE
integer
The titleId of the game that the request is being sent for.
Request header
Name
Required
Type
Description
Authorization
TRUE
integer
Caller must supply an XToken in the XBL 3.0 authorization format. For example, Authorization: XBL3.0 x=2553948354698;>encrypted token<)
Content-Type
TRUE
string
ContentType must be set to application/json
Request body
Name
Required
Type
Description
invitedUsers
TRUE
string[]
The XUID of the users the invite is being sent to. The XUID is represented as a base 10 integer. The maximum is 16 XUIDs.
connectionString
string
The connection string is what gets passed to the game when the invite reaches the user. The connection string usually contains information like the server IP to enable the invited user to join. If the connection string field is left empty then the title is invoked with an empty connection string. The length of the connection string is restricted to 512 characters.
An error occurred while processing the request. Possible error codes: "RequestValidationError: The request validation has failed.", " AuthorizationError: The caller is not allowed to access the resource. Too many requests."
Human readable version of the error message that can be used for debugging.
errorCode
string
Error code enum.
Platform
Name
Type
Description
Android
string
IOS
string
Nintendo
string
PlayStation
string
Scarlett
string
Win32
string
WindowsOneCore
string
XboxOne
string
SendInviteRequest
If the platform is not set in the request, the invite will allow the recipient to join on any platform the game can be played on. Otherwise, it will include only the listed platform.
Note: the exception to this is that if Scarlett is not configured as a platform, then invites specifying XboxOne will also be sent to Scarlett devices.
Name
Type
Description
connectionString
string
The connection string is what gets passed to the game when the invite reaches the user. The connection string usually contains information like the server IP to enable the invited user to join. If the connection string field is left empty then the title is invoked with an empty connection string. The length of the connection string is restricted to 512 characters.
invitedUsers
string[]
The XUID of the users the invite is being sent to. The XUID is represented as a base 10 integer. The maximum is 16 XUIDs.