---
title: "Create a broadcast tournament"
method: POST
path: "/broadcast/new"
tags: ["Broadcasts"]
---

# Create a broadcast tournament

`POST /broadcast/new`

Create a new broadcast tournament to relay external games.
This endpoint accepts the same form data as the [web form](https://lichess.org/broadcast/new).

## Response `200`

The broadcast tournament was successfully created.

- BroadcastWithRounds
  - `tour` BroadcastTour, required
    - `id` string, required
    - `name` string, required
    - `slug` string, required
    - `createdAt` integer, required
    - `dates` integer[] — Start and end dates of the tournament, as Unix timestamps in milliseconds
    - `info` BroadcastTourInfo — Additional display information about the tournament
      - `format` string — Tournament format. Example: `"8-player round-robin" or "5-round Swiss"`
      - `tc` string — Time control. Example: `"Classical" or "Rapid" or "Rapid & Blitz"`
      - `fideTC` 'standard' | 'rapid' | 'blitz' — FIDE rating category
      - `timeZone` string — Timezone of the tournament. Example: `America/New_York`. See [list of possible timezone identifiers](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) for more.
      - `location` string — Tournament location
      - `players` string — Mentioning up to 4 of the best players participating.
      - `website` string, uri — Official website. External website URL
      - `standings` string, uri — Official standings website. External website URL, e.g. chess-results.com, info64.org
      - `regulations` string, uri — External URL to the official tournament regulations.
    - `tier` integer — Used to designate featured tournaments on Lichess
    - `image` string, uri
    - `description` string — Full tournament description in markdown format, or in HTML if the html=1 query parameter is set.
    - `teamTable` boolean
    - `showTeamScores` boolean
    - `url` string, uri, required
    - `communityOwner` LightUser
      - `id` string, required
      - `name` string, required
      - `flair` string — See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
      - `title` 'GM' | 'WGM' | 'IM' | 'WIM' | 'FM' | 'WFM' | 'NM' | 'CM' | 'WCM' | 'WNM' | 'LM' | 'BOT' — only appears if the user is a titled player or a bot user
      - `patron` boolean — Use patronColor value instead to determine if player is a patron.
      - `patronColor` integer — Players can choose a color for their Patron wings. See [here for the color mappings](https://github.com/lichess-org/lila/blob/master/ui/lib/css/abstract/_patron-colors.scss). The presence of this field indicates the player is an active Patron.
  - `group` string
  - `rounds` BroadcastRoundInfo[], required
    - `id` string, required
    - `name` string, required
    - `slug` string, required
    - `createdAt` integer, required
    - `rated` boolean, required — Whether the round is used for rating calculations
    - `ongoing` boolean
    - `startsAt` integer
    - `startsAfterPrevious` boolean — The start date/time is unknown and the round will start automatically when the previous round completes
    - `finishedAt` integer
    - `finished` boolean
    - `url` string, uri, required
    - `delay` integer
    - `customScoring` BroadcastCustomScoring — Scoring overrides for wins or draws.
      - `white` BroadcastCustomPointsPerColor, required
        - `win` number, required
        - `draw` number, required
      - `black` BroadcastCustomPointsPerColor, required
        - `win` number, required
        - `draw` number, required
  - `defaultRoundId` string
  - `photos` BroadcastPhotos — Photos of players, when available. The object keys are FIDE IDs

## Other responses

- `400` — The creation of the broadcast tournament failed.

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)