---
search:
  tags:
    - Teams
    - POST
seo:
  description: >-
    Create a team before the roster locks; a hidden reference team may…
    Reference for the POST /api/admin/teams endpoint in the Athena
    Attack/Defence Admin API.
sidebar:
  label: >-
    Create a team before the roster locks; a hidden reference team may be
    memberless and is admitted but never scored
  badge: POST
title: >-
  Create a team before the roster locks; a hidden reference team may be
  memberless and is admitted but never scored
type: openapi-operation
---
`POST /api/admin/teams`

**Request body** (`application/json`, required)

- `name` (string, required)
- `handle` (string, required)
- `leaderUserId` (string | null)
- `hidden` (boolean, required)

Request body example:

```json
{
  "name": "string",
  "handle": "string",
  "leaderUserId": "string",
  "hidden": false
}
```

**Responses**

- `200` — Success
- `401` — Unauthorized
- `404` — Response for status 404
- `409` — Response for status 409
- `422` — Validation failed
- `500` — Unhandled server error

Response example, 200:

```json
{
  "id": "string",
  "handle": "string",
  "name": "string"
}
```
