---
title: "POST /tenants/{tenantID}/users"
method: POST
path: "/tenants/{tenantID}/users"
---

# POST /tenants/{tenantID}/users

`POST /tenants/{tenantID}/users`

Record new user

** Required security scopes**:

## Path parameters

- `tenantID` integer, required

## Request body

- CreateUserPayload
  - `email` string, required
  - `first_name` string, required
  - `id` integer
  - `last_name` string, required
  - `password` string, required
  - `role` string, required
  - `validated` boolean
  - `validation_code` string

## Response `201`

Resource created

## Changes

- **2016-04-19** `3c07e4273a35` — 1 info
  - endpoint added
- **2016-04-14** `f87b3afefe7c` — 1 breaking
  - api path removed without deprecation
- **2016-04-12** `1c154a26f5a6` — 1 info
  - endpoint added
- **2015-11-17** `27d9759e9201` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/gopheracademy/apis/congo/changes/tenants/:tenantID/users/post.md)

---

[API](https://skmtc.dev/gopheracademy/apis/congo.md) · [All operations](https://skmtc.dev/gopheracademy/apis/congo/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gopheracademy/congo/revisions/b04a02c4ad1b/schema)