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

# Create user

`POST /api/v1/users`

## Query parameters

- `send_email` boolean

## Headers

- `X-Api-Key` string, required
- `X-Workspace-Id` string

## Request body

- object
  - `first_name` string
  - `middle_name` string
  - `last_name` string
  - `email` string, email
  - `personal_email` string, email
  - `timezone` string
  - `language` string
  - `department` integer
  - `team` integer
  - `level` string
  - `title` string
  - `address` string
  - `originally_hired` string, date
  - `joined_on` string, date
  - `terminated_on` string, date
  - `employee_id` string
  - `date_of_birth` string, date
  - `phone_number` string
  - `gender` string
  - `state` string
  - `city` string
  - `country` string
  - `hr` integer
  - `manager` integer
  - `is_deleted` boolean
  - `deleted_at` string, date-time
  - `employment_status` string
  - `slack_id` string
  - `azure_id` string
  - `external_id` string
  - `external_app_type` 'MICROSOFT' | 'OKTA' | 'GOOGLE' | 'RAPID7' | 'JUMPCLOUD'
  - `org_roles` integer[]
  - `password` string
  - `profile_image` integer
  - `custom_fields` ApiV1UsersPostRequestBodyContentApplicationJsonSchemaCustomFields
  - `has_reporters` boolean
  - `type` 'EMPLOYEE' | 'EXTERNAL' | 'AI_EMPLOYEE'
  - `workspaces` ApiV1UsersPostRequestBodyContentApplicationJsonSchemaWorkspacesItems[]
    - `id` integer
    - `roles` integer[]
  - `notification_enabled` boolean

## Response `200`

Successful response

- UsersPostapiV1UsersResponse200 — Empty response body

---

[API](https://skmtc.net/atomicwork/apis/atomicwork-public-api.md) · [All operations](https://skmtc.net/atomicwork/apis/atomicwork-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atomicwork/atomicwork-public-api/revisions/2e7047b35062/schema)