---
title: "Create User"
method: POST
path: "/organizations/users"
---

# Create User

`POST /organizations/users`

Creates a new user. Users created this way are not granted access to the Dashboard, and can only be authenticated using the [Authenticate Whitelabel User](/reference/organizations/authenticate-whitelabel-user) api. The user must be created with at least one permission assignment: either account_permissions, account_group_permissions, or both.

## Request body

- object
  - `email` string, email, required — User email address.
  - `first_name` string, required — First name.
  - `last_name` string, required — Last name.
  - `account_permissions` object[] — Direct account permission assignments.
    - `account_id` string, uuid, required — Account UUID (must belong to the org).
    - `role_id` string, required — Role ID (non-admin, non-staff, org-scoped).
  - `account_group_permissions` object[] — Account group permission assignments.
    - `account_group_id` string, uuid, required — Account group UUID (must belong to the org).
    - `role_id` string, required — Role ID (non-admin, non-staff, org-scoped).

## Response `201`

Created

- object
  - `id` string, uuid
  - `email` string
  - `first_name` string
  - `last_name` string
  - `account_permissions` object[]
    - `account_id` string, uuid
    - `role_id` string
  - `account_group_permissions` object[]
    - `account_group_id` string, uuid
    - `role_id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

---

[API](https://skmtc.net/y/apis/ai-caller.md) · [All operations](https://skmtc.net/y/apis/ai-caller/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/y/ai-caller/revisions/05b629819b49/schema)