---
title: "Create a league."
method: POST
path: "/api/league"
tags: ["League"]
---

# Create a league.

`POST /api/league`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/league`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/league/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a league along with its seasons (when dates are provided), default per-platform social scraping settings, league items and assistants.

## Request body

- LeagueStoreRequest
  - `name` string, nullable: League name.
  - `short_name` string, nullable: League short name.
  - `currency` string, nullable: ISO currency code.
  - `logo_url` string, nullable: URL of the league logo image.
  - `website_url` string, nullable: League website URL.
  - `sport_id` integer, nullable: Associated sport ID.
  - `owner_id` integer, nullable: League owner user ID.
  - `scouting_priority` integer, nullable: Scouting priority.
  - `platforms_scouted` integer, nullable: Number of platforms scouted.
  - `times_scouted_per_year` integer, nullable: Times scouted per year.
  - `genre_id` integer, nullable: Genre ID.
  - `subgenre_id` integer, nullable: Subgenre ID.
  - `release_date` string, nullable: Season release date (MM/DD).
  - `start_date` string, nullable: Season start date (MM/DD).
  - `end_date` string, nullable: Season end date (MM/DD).
  - `social_start_date` string, nullable: Social scraping start date (MM/DD).
  - `social_end_date` string, nullable: Social scraping end date (MM/DD).
  - `notes` string, nullable: Free-text notes.
  - `assistants` integer[]: User IDs to assign as league assistants.
  - `is_continuous` boolean: Whether the league runs continuously (no fixed season window). Accepts true/false or 1/0; null is not accepted.
  - `separator_text` string, nullable: Separator label used in listings.

## Response `200`

The created league with its seasons and logo.

## Other responses

- `400`: Wrong parameters (e.g. too many assistants or invalid date order).
- `403`: The user lacks the permission required to create leagues.
- `500`: Server error

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)