---
title: "Create User"
method: POST
path: "/users"
tags: ["Users"]
---

# Create User

`POST /users`

## Headers

- `X-CompanyCam-User` string

## Request body

- object
  - `user` object
    - `first_name` string
    - `last_name` string
    - `email_address` string
    - `phone_number` string
    - `password` string
    - `user_role` string — Role for the user. Allowed values: standard (default), restricted

## Response `201`

The created user

- User
  - `id` string, required
  - `company_id` string
  - `email_address` string
  - `status` 'active' | 'deleted' — Indicates the status of the Company.
  - `first_name` string
  - `last_name` string
  - `profile_image` ImageURI[] — A list of images for the different variants of the user profile image
    - `type` string, required
    - `uri` string, required
    - `url` string
  - `phone_number` string, nullable
  - `created_at` integer
  - `updated_at` integer
  - `user_url` string

## Other responses

- `400` — Bad Request
- `404` — Not found
- `500` — Unexpected error

---

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