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

# Create User

`POST /organizations/users`

Creates a new user in the specified organization. Requires a valid API key and proper permissions to create users. The user will be assigned to the specified team and given the specified role. Returns the created user's details including their UUID.

## Request body

- CreateUserRequest
  - `email` string, required — The email address of the new user.
  - `first_name` string, required — The first name of the new user.
  - `last_name` string, required — The last name of the new user.
  - `password` string — The password for the new user's account.
  - `teams` TeamRequest[], required — A list of teams the user will belong to. Each team requires a UUID.
    - `uuid` string, required — The UUID of the team the user will belong to.
    - `primary` boolean — Whether this team is the user's primary team.
  - `roleUUID` string, required — The UUID of the role assigned to the user.
  - `seat_type` 'listener' | 'recording' — The type of seat assigned to the user.

## Response `200`

User successfully created

- CreateUserResponse
  - `data` User
    - `uuid` string — The unique identifier of the user.
    - `email` string — The email address of the user.
    - `firstName` string — The first name of the user.
    - `lastName` string — The last name of the user.
    - `createdAt` string — The date and time the user was created.
    - `deletedAt` string — The date and time the user was deactivated.
    - `transcriptLang` string — The preferred transcript language for the user.
    - `joinOutsideHostMeetings` boolean — Indicates if the user can join meetings outside their host organization.
    - `realTimeCapabilities` boolean — Indicates if the user has real-time transcription capabilities.
    - `settings` UserSettings
      - `realTimeCapabilitiesOFF` boolean
      - `autoCalculateCRMFields` boolean
      - `joinWhenIAmHostAndAlone` boolean
      - `joinWhenIAmHostWithPeers` boolean
      - `joinWhenPeerIsHost` boolean
      - `joinWhenUnlicensedPeerIsHost` boolean
      - `dealsEnabled` boolean
    - `botName` string — The name of the bot associated with the user.
    - `botImageURL` string — The URL of the bot's profile image.
    - `primaryTeamUUID` string — The UUID of the user's primary team.
    - `organizationRoleUUID` string — The UUID of the user's role in the organization.
    - `roles` Role[] — A list of roles assigned to the user.
      - `uuid` string
      - `name` string
      - `type` string
    - `showReferralScreen` boolean — Whether the user is shown a referral screen.
    - `seatType` string — The type of seat assigned to the user.
    - `teams` Team[] — A list of teams assigned to the user.
      - `uuid` string — Unique identifier of the team
      - `name` string — Name of the team
      - `phrases` string[] — List of keywords or phrases associated with the team
      - `slackConnection` SlackConnection — Represents the Slack integration details for a team
        - `id` string — Slack connection identifier
        - `info` SlackTeamInfo — Information about a connected Slack team
          - `id` string — Slack team identifier
          - `name` string — Name of the Slack team
      - `domain` string — Domain associated with the team
      - `organizerJoinInternalMeetings` boolean — Whether team organizers can join internal meetings
      - `consentEmailEnabled` boolean — Whether email consent is enabled for the team
      - `parentTeamUUID` string — UUID of the parent team if this team is part of a hierarchy
      - `organizationUUID` string — UUID of the organization this team belongs to
      - `children` Team[] — List of child teams if this team has a hierarchical structure

## Other responses

- `400` — Team does not exist or is not part of the organization
- `401` — Valid API key required
- `422` — Missing required fields in body
- `500` — Unexpected server error. Please try again later.
- `default` — unexpected error

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)