---
title: "Create Org User"
method: POST
path: "/v1/admin/orgs/{org_id}/users"
tags: ["admin"]
---

# Create Org User

`POST /v1/admin/orgs/{org_id}/users`

## Request

- Base URL: `https://api.claims.zicron.ai`
- URL: `https://api.claims.zicron.ai/v1/admin/orgs/{org_id}/users`
- Auth: none declared

Create a user in an organization.

If the email already exists, creates an accepted OrgMembership instead of
failing with 409. This allows admins to add existing users to their org.

## Path parameters

- `org_id` string, required

## Request body

- CreateOrgUserRequest
  - `email` string, required
  - `password` string, nullable
  - `name` string, required
  - `role` string

## Response `201`

Successful Response

- OrgUserResponse
  - `id` string, required
  - `email` string, required
  - `name` string, required
  - `role` string, required
  - `persona` string, nullable
  - `allowed_claim_types` string[], nullable
  - `allowed_personas` string[], nullable
  - `is_active` boolean, required
  - `is_superadmin` boolean, required
  - `mfa_enabled` boolean
  - `require_mfa_setup` boolean
  - `created_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zicron/apis/zicron-api.md) · [All operations](https://skmtc.dev/zicron/apis/zicron-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zicron/apis/zicron-api/revisions/abe62e22aa46?raw)