---
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

- LseUserRequest — 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
  - `allow_newsletters` boolean, nullable — Allow sending newsletters to user
  - `custom_hotkeys` unknown
  - `date_joined` string, date-time
  - `email` string, email
  - `first_name` string
  - `last_name` string
  - `password` string
  - `phone` string
  - `username` string, required

## 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` object, required
  - `allow_newsletters` boolean, nullable — Allow sending newsletters to user
  - `avatar` string, nullable, 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` object, required — Get email notification settings with organization-level filtering. Use the model's getter method to ensure all notification types are included with proper defaults for any missing types. Transform the output to include both value and label for each notification type. Filter notifications based on organization's allowed notifications if user belongs to exactly one organization. Role-based filtering: not_activated_user_login is only available to users who are admins or owners in at least one organization.
    - `invite_activated` boolean, nullable
    - `invite_expired` boolean, nullable, required
    - `invite_expired_at` string, date-time, nullable, 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` boolean, required
    - `flex` object, nullable, required — Flex claim/window state for FE expired-seat UX (FIT-2339). Non-Flex → null.
    - `organization_id` integer, required — Organization ID
    - `role` string, required
    - `user_type` string, nullable, required
  - `organization_membership` OrganizationMembership, required
    - `active` boolean, required
    - `flex` object, nullable, required — Flex claim/window state for FE expired-seat UX (FIT-2339). Non-Flex → null.
    - `organization_id` integer, required — Organization ID
    - `role` string, required
    - `user_type` string, nullable, required
  - `pause` object, nullable, required
  - `phone` string
  - `username` string, required

---

[API](https://skmtc.net/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.net/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/versions/1b113b8df950/schema)