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

# Create new user

`POST /api/users/`

Create a user in Label Studio.

## Request body

- object
  - `allow_newsletters` boolean — Whether the user allows newsletters
  - `avatar` string — Avatar URL of the user
  - `email` string — Email of the user
  - `first_name` string — First name of the user
  - `id` integer — User ID
  - `initials` string — Initials of the user
  - `last_name` string — Last name of the user
  - `phone` string — Phone number of the user
  - `username` string — Username of the user

## Response `201`

- LseUser — A ModelSerializer that takes additional arguments for "fields", "omit" and "expand" in order to control which fields are displayed, and whether to replace simple values with complex, nested serializations
  - `active_organization` integer, nullable
  - `active_organization_meta` string, required
  - `allow_newsletters` boolean, nullable — Allow sending newsletters to user
  - `avatar` string, required
  - `custom_hotkeys` unknown
  - `date_joined` string, date-time
  - `email` string, email
  - `first_name` string
  - `id` integer, required
  - `initials` string, required
  - `last_activity` string, date-time, required
  - `last_name` string
  - `lse_fields` LseFields, required
    - `email_notification_settings` string, required
    - `invite_activated` boolean, nullable
    - `invite_expired` string, required
    - `invite_expired_at` string, required
    - `invited_at` string, date-time, nullable
    - `invited_by` integer, nullable
    - `onboarding_state` 'not_started' | 'signup' | 'trial_signup' | 'first_tutorial' | 'in_app_guidance' | 'complete' — * `not_started` - Not Started * `signup` - Signup * `trial_signup` - Trial Signup * `first_tutorial` - First Tutorial * `in_app_guidance` - In App Guidance * `complete` - Complete
    - `social_auth_finished` boolean, nullable — Is user finished social authentication
    - `trial_company` string, nullable
    - `trial_experience_labeling` string, nullable
    - `trial_license_enterprise` boolean, nullable
    - `trial_models_in_production` string, nullable
    - `trial_role` 'annotator' | 'annotator_team_manager' | 'business_analyst' | 'business_or_data_team_leadership' | 'data_engineer_platform_engineer' | 'data_scientist' | 'other' — * `annotator` - Annotator * `annotator_team_manager` - Annotator Team Manager * `business_analyst` - Business Analyst * `business_or_data_team_leadership` - Business Or Data Team Leadership * `data_engineer_platform_engineer` - Data Engineer Platform Engineer * `data_scientist` - Data Scientist * `other` - Other
  - `org_membership` OrganizationMembership[], required
    - `active` string, required
    - `organization_id` integer, required — Organization ID
    - `role` string, required
  - `organization_membership` OrganizationMembership, required
    - `active` string, required
    - `organization_id` integer, required — Organization ID
    - `role` string, required
  - `pause` string, required
  - `phone` string
  - `username` string, required

---

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