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

# Create a user

`POST /v3/users`

Creates a new user.

## Request body

- UserCreation
  - `validators` LegacyValidators — Validators are not required for user creation, users created without validators won't be able to sign into Zephr unless they follow a password reset flow, or being mapped as shadow users identified by a JWT.
    - `password` string
    - `legacy_password` string — Legacy Passowrd is used only if the tenant has Login extension active. More information can be found here https://docs.zuora.com/en/zephr/configuration--integrations/settings/extensions/login-extension
  - `identifiers` Identifiers, required
    - `email_address` string
  - `attributes` Attributes
    - `first_name` string
    - `surname` string
  - `accountMembershipCode` string
  - `email_verified` boolean
  - `last_login` string
  - `tracking_id` string
  - `registered` string
  - `registration_state` object
    - `partial` string
    - `complete` string
    - `contact` string
  - `registration_tenant` string
  - `session_limit` integer
  - `foreign_keys` object[]
  - `product_sharing_id` string
  - `created_at` string

## Response `201`

Created

- UsersResponse
  - `results` UserResponse[]
    - `user_id` string
    - `identifiers` Identifiers
      - `email_address` string
    - `attributes` Attributes
      - `first_name` string
      - `surname` string
    - `email_verified` boolean

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/zuora/apis/admin-api-reference.md) · [All operations](https://skmtc.net/zuora/apis/admin-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zuora/admin-api-reference/revisions/789812d35ac8/schema)