---
title: "Create User"
url: "https://kiwi.arashsheyda.me/apis/stoplight-3/versions/8b88146a-3da5-4ca7-8179-7ad4727ac5a1/operations/post-users-userID"
---

> Full API specification: https://kiwi.arashsheyda.me/apis/stoplight-3/versions/8b88146a-3da5-4ca7-8179-7ad4727ac5a1.md

# Create User

`POST` `/users`

Operation ID: `post-users-userID`

Create a User

## Request body

Content types: `application/json`

## Responses

- `201` - User Created

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: To-dos
  version: 1.0.0
servers:
  - url: https://todos.stoplight.io
    description: Production
  - description: Sandbox
    url: https://todos-sandbox.stoplight.io
paths:
  /users:
    parameters: []
    post:
      summary: Create User
      operationId: post-users-userID
      responses:
        "201":
          description: User Created
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/User"
              examples:
                Example User:
                  $ref: "#/components/examples/user"
      description: Create a User
      requestBody:
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/User"
            examples: {}
      tags:
        - Users
      security:
        - API Key: []
security:
  - API Key: []
components:
  schemas:
    User:
      description: ""
      type: object
      title: User
      properties:
        userId:
          type: number
          description: ID of the user
          readOnly: true
        firstName:
          type: string
          minLength: 1
          description: ""
        lastName:
          type: string
          minLength: 1
          description: ""
        phoneNumber:
          type: string
          minLength: 1
          description: Official Phone Number
        emailAddress:
          type: string
          minLength: 1
          description: Work Email Address
      required:
        - userId
        - firstName
        - lastName
        - phoneNumber
        - emailAddress
  examples:
    user:
      value:
        userId: 2
        firstName: racks
        lastName: jacson
        phoneNumber: "123456"
        emailAddress: racks.jacson@learningcontainer.com
  securitySchemes:
    API Key:
      name: apikey
      type: apiKey
      in: query
      description: Just use `123`. It's super secure ;)
```