---
title: "create"
method: POST
path: "/api/v1/users"
tags: ["API::V1::Registration"]
---

# create

`POST /api/v1/users`

## Request body

- object
  - `user` object, required
    - `email` string, required
    - `password` string, required
    - `password_confirmation` string, required
    - `username` string, required
    - `first_name` string, required
    - `last_name` string, required

## Response `200`

does not return a Set-Cookie Header

- object
  - `user` object, required
    - `id` integer, required
    - `email` string, required
    - `name` string, required
    - `username` string, required
    - `first_name` string, required
    - `last_name` string, required
    - `uid` string, required
    - `provider` string, required
    - `created_at` string, required
    - `updated_at` string, required

## Other responses

- `422` — does not create a user

## Changes

- **2024-03-06** `efb566fd664a` — 1 info
  - added the required property `data/impersonated_by` to the response with the `422` status
- **2023-11-27** `bf90c65dbe64` — 2 info
  - api tag `API::V1::Registration` added
  - api tag `Api::V1::Registration` removed
- **2023-10-24** `9bcc35c89330` — 2 breaking, 8 warning, 6 info
  - the request property `user/password` became required
  - the request property `user/password_confirmation` became required
  - removed the request property `user/created_at`
  - removed the request property `user/id`
  - …12 more
- **2023-10-24** `238ff9873a31` — 7 breaking, 12 info
  - the response property `user/created_at` became optional for the status `200`
  - the response property `user/id` became optional for the status `200`
  - the response property `user/name` became optional for the status `200`
  - the response property `user/provider` became optional for the status `200`
  - …15 more

[Change history](https://skmtc.dev/rootstrap/apis/rails-api-base/changes/api/v1/users/post.md)

---

[API](https://skmtc.dev/rootstrap/apis/rails-api-base.md) · [All operations](https://skmtc.dev/rootstrap/apis/rails-api-base/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rootstrap/rails-api-base/revisions/5b193a22afbc/schema)