---
title: "Create Tournament Category"
method: POST
path: "/api/v3/tournaments/categories"
tags: ["Tournaments"]
---

# Create Tournament Category

`POST /api/v3/tournaments/categories`

## Request

- Base URL: `https://dev-api.genji.pk`
- URL: `https://dev-api.genji.pk/api/v3/tournaments/categories`
- Auth: none declared

Create a new tournament category with difficulty groupings.

## Request body

- TournamentCategoryCreateRequest
  - `name` string, required
  - `difficulties` string[], required
  - `participation_xp` integer
  - `placement_xp` PlacementXpTier[]
    - `place` integer, required
    - `xp` integer, required
  - `streak_xp` StreakXpTier[]
    - `threshold` integer, required
    - `xp` integer, required
  - `champion_role_id` integer, nullable

## Response `201`

Document created, URL follows

- TournamentCategoryResponse
  - `id` integer, required
  - `name` string, required
  - `difficulties` string[], required
  - `participation_xp` integer, required
  - `placement_xp` PlacementXpTier[], required
    - `place` integer, required
    - `xp` integer, required
  - `streak_xp` StreakXpTier[], required
    - `threshold` integer, required
    - `xp` integer, required
  - `champion_role_id` integer, nullable
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Bad request syntax or unsupported method

---

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