---
title: "Create new user for tenant"
method: POST
path: "/tenant/{tenant_name}/users"
tags: ["tenant - users"]
---

# Create new user for tenant

`POST /tenant/{tenant_name}/users`

## Path parameters

- `tenant_name` string, required

## Request body

- NBUserCreateRequest
  - `username` string, required
  - `password` string, password, required
  - `email` string, required
  - `role` 'admin' | 'viewer' | 'editor' | 'remote_user' | 'partner', required
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `phone` string, nullable
  - `description` string, nullable
  - `enabled` boolean
  - `password_is_expired` boolean
  - `is_remote_user` boolean
  - `partner_id` string, nullable

## Response `201`

Successful Response

- NBUser
  - `id` string, required
  - `username` string, required
  - `email` string, required
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `phone` string, nullable
  - `description` string, nullable
  - `role` 'admin' | 'viewer' | 'editor' | 'remote_user' | 'partner'
  - `is_remote_user` boolean
  - `enabled` boolean, required
  - `password_is_expired` boolean, required
  - `remaining_failed_attempts` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/zayo/apis/niro-api.md) · [All operations](https://skmtc.net/zayo/apis/niro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zayo/niro-api/versions/c52ac26e1766/schema)