---
title: "Create a broadcast round"
method: POST
path: "/broadcast/{broadcastTournamentId}/new"
tags: ["Broadcasts"]
---

# Create a broadcast round

`POST /broadcast/{broadcastTournamentId}/new`

Create a new broadcast round to relay external games.
This endpoint accepts the same form data as the web form.

Choose one between `syncUrl`, `syncUrls`, `syncIds` and `syncUsers`, if it is missing, the broadcast needs to be fed by [pushing PGN to it](#tag/broadcasts/POST/api/broadcast/round/{broadcastRoundId}/push)

## Path parameters

- `broadcastTournamentId` string, required

## Response `200`

The broadcast round was successfully created.

- BroadcastRoundNew
  - `round` 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
  - `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.
  - `study` BroadcastRoundStudyInfo, required
    - `writeable` boolean — Whether the currently authenticated user has permission to update the study
    - `features` object
      - `chat` boolean — Whether chat is enabled for the currently authenticated user
      - `computer` boolean — Whether engine analysis is enabled for the currently authenticated user
      - `explorer` boolean — Whether the opening explorer + tablebase is enabled for the currently authenticated user

## Other responses

- `400` — The creation of the broadcast 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)