---
title: "Create a new subcategory"
method: POST
path: "/api/subcategory"
tags: ["Subcategory"]
---

# Create a new subcategory

`POST /api/subcategory`

## 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/subcategory`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/subcategory/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new subcategory with the provided data

## Request body

- SubcategoryStoreRequest
  - `name` string, nullable: Name of the subcategory
  - `category_id` string, required: ID of the parent category
  - `synopsis` string, nullable: Brief description of the subcategory
  - `always_in_social_review` boolean: Whether this subcategory is always included in social review
  - `leagues_social_review` integer[]: Array of league IDs for social review
  - `always_in_social_reject` boolean: Whether brands in this subcategory are always auto-rejected in social scans
  - `leagues_social_reject` integer[]: Array of league IDs for social auto-reject

## Response `200`

Subcategory created successfully

- object
  - `id` integer
  - `name` string
  - `category_id` integer
  - `synopsis` string, nullable
  - `always_in_social_review` boolean
  - `leagues_in_social_review` object[]
    - `id` integer
    - `name` string
  - `always_in_social_reject` boolean
  - `leagues_in_social_reject` object[]
    - `id` integer
    - `name` string

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden
- `422`: Validation error
- `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)