---
title: "POST /api/v1/users"
method: POST
path: "/api/v1/users"
tags: ["users"]
---

# POST /api/v1/users

`POST /api/v1/users`

Create a new user

## Request body

- NewUser
  - `clientUserId` string, required
  - `clientUserEmail` string
  - `firstName` string
  - `middleName` string
  - `lastName` string
  - `gender` 'male' | 'female' | 'other'
  - `dateOfBirth` string — A string with one of the following formats: - YYYY-MM-DD Example: 1990-12-30 - M/D/YY Example: 3/23/89 - M/D/YYYY Example: 2/12/2004 - YYYY-MM-DDTHH:mmZ as ECMA-262 Example: 1990-12-30T00:00Z the timezone is optional - YYYY-MM-DDTHH:mm:ssZ as ECMA-262 Example: 1990-12-30T00:00:00Z the timezone is optional - YYYY-MM-DDTHH:mm:ss.sssZ as ECMA-262 Example: 1990-12-30T00:00:00.000Z the timezone is optional
  - `ssn` string
  - `phone` string
  - `autoInvite` boolean
  - `orderType` string
  - `clientData` object
  - `suggestedSources` string[]
  - `conditions` string[] — Include order-specific conditions or additional instructions for APS retrieval orders
  - `address` Address
    - `street1` string, required
    - `street2` string
    - `city` string, required
    - `state` string, required
    - `zip` integer, required
  - `providers` Provider[]
    - `name` string, required
    - `organizationName` string
    - `clientProviderId` string
    - `address` Address, required
      - `street1` string, required
      - `street2` string
      - `city` string, required
      - `state` string, required
      - `zip` integer, required
    - `phone` string
    - `fax` string
    - `mrn` string
    - `npi` union — This field can be a string, number, or an empty string.
      - string
      - number
  - `attachments` Attachment[]
    - `type` string, required
    - `contentType` string, required
    - `encoding` string, required
    - `content` string, required

## Response `201`

Created

- User[]
  - `firstName` string
  - `lastName` string
  - `dateOfBirth` string, date-time
  - `humanId` string, required
  - `clientUserEmail` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `status` string, required
  - `suggestedSources` string[]
  - `inviteLink` string

## Other responses

- `202` — Accepted
- `400` — There is a semantic error with the content of the request
- `401` — The token provided is invalid. It may have expired or may have been revoked.
- `404` — The specified resource was not found (e.g. the id does not exist)
- `409` — There is a conflict with the specified resource (e.g. it may already exist)

---

[API](https://skmtc.dev/humanapi/apis/admin-api.md) · [All operations](https://skmtc.dev/humanapi/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humanapi/admin-api/revisions/23ae65b043bf/schema)