# Create a user

Creates a new user.

Endpoint: POST /v3/users
Version: 2026-01-08
Security: ZephrHmacHttp

## Request fields (application/json):

  - `validators` (object)
    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.

  - `validators.password` (string)

  - `validators.legacy_password` (string)
    Legacy Passowrd is used only if the tenant has Login extension active. More information can be found here https://knowledgecenter.zuora.com/Zephr/Settings/Extensions/Login_Extension

  - `identifiers` (object, required)

  - `identifiers.email_address` (string)
    Example: "joe.blow@company.com"

  - `attributes` (object)

  - `attributes.first_name` (string)
    Example: "Joe"

  - `attributes.surname` (string)
    Example: "Blow"

  - `accountMembershipCode` (string)

  - `email_verified` (boolean)

  - `last_login` (string)

  - `tracking_id` (string)

  - `registered` (string)

  - `registration_state` (object)

  - `registration_state.partial` (string)

  - `registration_state.complete` (string)

  - `registration_state.contact` (string)

  - `registration_tenant` (string)

  - `session_limit` (integer)

  - `foreign_keys` (array)

  - `product_sharing_id` (string)

  - `created_at` (string)

## Response 201 fields (application/json):

  - `results` (array)

  - `results.user_id` (string)
    Example: "123456789ABCD"

  - `results.identifiers` (object)

  - `results.identifiers.email_address` (string)
    Example: "joe.blow@company.com"

  - `results.attributes` (object)

  - `results.attributes.first_name` (string)
    Example: "Joe"

  - `results.attributes.surname` (string)
    Example: "Blow"

  - `results.email_verified` (boolean)
    Example: true


## Response 400 fields