> ## 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. # PlayFabMultiplayer.CreateMatchmakingTicket > PlayFabMultiplayer.CreateMatchmakingTicket ## Method (1 of 3) Creates a matchmaking ticket for one or more local users. ```csharp theme={null} public static MatchmakingTicket CreateMatchmakingTicket(IList localUsers, string queueName, uint timeoutInSeconds = 120) ``` | parameter | description | | ---------------- | ----------------------------------------------------------------------------------- | | localUsers | The array of local users along with local user attributes to include in the ticket. | | queueName | The queue to which the ticket belongs. | | timeoutInSeconds | How long to attempt matchmaking the ticket, in seconds. Defaults to 120 seconds | ## Return Value (1 of 3) The resulting ticket object. ## Remarks (1 of 3) The library automatically, and asynchronously, will submit all local users on a ticket to the matchmaking service. Each time the ticket status changes, a [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) will be provided. The ticket status can be queried at any time via [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). The ticket immediately starts in the `MatchmakingTicketStatus.Creating` state. When the ticket has completed, a [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) will be provided. At that point, a match will have been found or the ticket stopped due to failure. On success, the match that was found can be queried via [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails). All existing tickets in which a local user is a member will be canceled as part of this operation. A match can't be found until all remote users specified in the `membersToMatchWith` field of the `configuration` parameter have joined the ticket via [`JoinMatchmakingTicketFromId`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId). *** ## Method (2 of 3) Creates a matchmaking ticket for one or more local users. ```csharp theme={null} public static MatchmakingTicket CreateMatchmakingTicket(MatchUser localUser, string queueName, uint timeoutInSeconds = 120) ``` | parameter | description | | ---------------- | ------------------------------------------------------------------------------- | | localUser | The local user along with local user attributes to include in the ticket. | | queueName | The queue to which the ticket belongs. | | timeoutInSeconds | How long to attempt matchmaking the ticket, in seconds. Defaults to 120 seconds | ## Return Value (2 of 3) The resulting ticket object. ## Remarks (2 of 3) The library automatically, and asynchronously, will submit all local users on a ticket to the matchmaking service. Each time the ticket status changes, a [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) will be provided. The ticket status can be queried at any time via [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). The ticket immediately starts in the `MatchmakingTicketStatus.Creating` state. When the ticket has completed, a [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) will be provided. At that point, a match will have been found or the ticket stopped due to failure. On success, the match that was found can be queried via [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails). All existing tickets in which a local user is a member will be canceled as part of this operation. A match can't be found until all remote users specified in the `membersToMatchWith` field of the `configuration` parameter have joined the ticket via [`JoinMatchmakingTicketFromId`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId). *** ## Method (3 of 3) Creates a matchmaking ticket for one or more local users. ```csharp theme={null} public static MatchmakingTicket CreateMatchmakingTicket(IList localUsers, string queueName, List membersToMatchWith, uint timeoutInSeconds = 120) ``` | parameter | description | | ------------------ | ----------------------------------------------------------------------------------- | | localUsers | The array of local users along with local user attributes to include in the ticket. | | queueName | The queue to which the ticket belongs. | | membersToMatchWith | The other specific users expected to join the ticket. | | timeoutInSeconds | How long to attempt matchmaking the ticket, in seconds. Defaults to 120 seconds | ## Return Value (3 of 3) The resulting ticket object. ## Remarks (3 of 3) The library automatically, and asynchronously, will submit all local users on a ticket to the matchmaking service. Each time the ticket status changes, a [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) will be provided. The ticket status can be queried at any time via [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status). The ticket immediately starts in the `MatchmakingTicketStatus.Creating` state. When the ticket has completed, a [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) will be provided. At that point, a match will have been found or the ticket stopped due to failure. On success, the match that was found can be queried via [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails). All existing tickets in which a local user is a member will be canceled as part of this operation. A match can't be found until all remote users specified in the `membersToMatchWith` field of the `configuration` parameter have joined the ticket via [`JoinMatchmakingTicketFromId`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId). ## See Also * class [MatchmakingTicket](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview) * struct [MatchUser](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview) * class [PFEntityKey](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview) * class [PlayFabMultiplayer](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/overview) * namespace [PlayFab.Multiplayer](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference) ## Related topics - [CreateServerBackfillTicket](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md) - [PlayFabMultiplayer.OnMatchmakingTicketCompleted](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketCompleted.md) - [PlayFabMultiplayer.JoinMatchmakingTicketFromId](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId.md) - [PlayFabMultiplayer.OnMatchmakingTicketStatusChanged](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged.md) - [Specifying attributes with your tickets](/services/playfab/multiplayer/matchmaking/ticket-attributes.md)