---
title: "Create a new buddy list invitation"
method: POST
path: "/v1/buddy-list/invitations"
tags: ["buddy-list"]
---

# Create a new buddy list invitation

`POST /v1/buddy-list/invitations`

## Request body

- CreateBuddyListInvitationRequestDTO
  - `gameSetAttempt` number — Required for multiple attempts with This_That game sets
  - `invitingPlayerGameResults` GameSetResult[], required
    - `gameId` string, required
    - `correctAnswer` boolean
  - `invitingPlayerId` string
  - `invitingPlayerUsername` string
  - `invitingPlayerAnalyticsId` string, required
  - `distributorId` string, required
  - `deepLinkUrl` string, required
  - `gameSetId` string, required

## Response `201`

The created buddy list invitation context object

- BuddyListInvitationEntity
  - `invitingPlayerIsRegistered` 'true' | 'false', required
  - `invitingPlayerGameResults` GameSetResult[], required
    - `gameId` string, required
    - `correctAnswer` boolean
  - `entityType` object, required
  - `invitingPlayerId` string, required
  - `invitingPlayerUsername` string, required
  - `invitingPlayerAnalyticsId` string, required
  - `shareCode` string, required
  - `distributorId` string, required
  - `deepLinkUrl` string, required
  - `gameSetId` string, required
  - `gameSetAttempt` number
  - `invitationDate` number, required
  - `buddyListId` string, required

## Other responses

- `400` — The request body is invalid

---

[API](https://skmtc.net/versusgame/apis/versusgame-api.md) · [All operations](https://skmtc.net/versusgame/apis/versusgame-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/versusgame/versusgame-api/revisions/e86f45ae5f7c/schema)