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

# Create User

`POST /v1/organizations/users`

Create a new organization user.

## Request body

- UserCreateRequest — Payload for creating an organization user.
  - `email` string, email, required — Unique email address within the organization.
  - `user_name` string, required — Display name shown in dashboards and audit trails.
  - `avatar_url` string, nullable — Profile picture URL (e.g., from PropelAuth picture_url property).
  - `role` 'admin' | 'member' | 'viewer' — High-level organization role applied to users. Roles define the baseline permissions a user has within an organization: - ADMIN: Full administrative access including user management, billing, and organization settings. Can create/modify/delete all resources. - MEMBER: Standard user access. Can create and manage their own resources (namespaces, collections, clusters) but cannot manage other users or organization-level settings. - VIEWER: Read-only access. Can view resources and execute retrievers but cannot create, modify, or delete any resources.
  - `status` 'active' | 'suspended' | 'pending' — Lifecycle state of an organization user. Status values control whether a user can authenticate and access resources: - ACTIVE: User is fully operational and can authenticate with their API keys. - SUSPENDED: User access is temporarily disabled. API keys will not work but account data is preserved. Can be reactivated by an admin. - PENDING: User invitation has been created but not yet accepted. User cannot authenticate until they complete the onboarding flow.
  - `metadata` object, nullable — Custom key/value metadata stored with the user record.

## Response `200`

Successful Response

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/5d4c905106b4/schema)