---
title: "Create a new user."
method: POST
path: "/users"
tags: ["Users"]
---

# Create a new user.

`POST /users`

## Request

- Base URL: `https://api.atletiek.nu/v1`
- URL: `https://api.atletiek.nu/v1/users`
- Auth: HTTP bearer

## Request body

- UserInput: Payload for creating a user.
  - `email` string, email, required
  - `first_name` string
  - `last_name` string
  - `birth_date` string, date
  - `nationality_id` string
  - `club_id` string
  - `password` string, password, required

## Response `201`

The created user.

- User: A user account. Personal data (email, birth date) is intentionally excluded from this representation; use the authenticated `GET /users/{user_id}/profile` endpoint to retrieve a user's own personal information.
  - `id` string
  - `first_name` string
  - `last_name` string
  - `nationality` Nationality: A nationality.
    - `iso` string: ISO country code.
    - `description` string
    - `flag` string, url: URL to the flag image.
  - `club` Club: An athletics club.
    - `id` string
    - `name` string
    - `short_name` string
    - `country` string
    - `city` string
    - `email` string, email

## Changes

> 13 revisions in range; 1 not diffed.

- **2026-06-12** `986d9d3f02e9`: 1 info
  - endpoint added
- **2026-06-12** `8c9189a8cd60`: 2 warning
  - removed the optional property `birth_date` from the response with the `201` status
  - removed the optional property `email` from the response with the `201` status

[Operation history](https://skmtc.dev/athletics-app/apis/atletiek-nu-competition-data-api/changes/users/post.md)

---

[API](https://skmtc.dev/athletics-app/apis/atletiek-nu-competition-data-api.md) - [All operations](https://skmtc.dev/athletics-app/apis/atletiek-nu-competition-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/athletics-app/apis/atletiek-nu-competition-data-api/revisions/cd49a90e4266?raw)