---
title: "Create User"
method: POST
path: "/api/v2/users"
tags: ["Configuration"]
---

# Create User

`POST /api/v2/users`

Create a new user in your workspace. Requires account admin role. Use for automated user provisioning or SCIM integrations.

## Request body

- object
  - `email_address` string, required
  - `first_name` string, required
  - `last_name` string, required
  - `account_role` 'Account User' | 'Account Admin' | 'Account Analyst' | 'Account Guest', required
  - `id` string, uuid, nullable
  - `profile_picture` string, nullable
  - `profile_color` string, nullable

## Response `201`

UserResponse(id: uuid.UUID, email_address: str, first_name: str, last_name: str, account_role: str, is_deleted: bool, profile_picture: Optional[str] = None, profile_color: Optional[str] = None)

- object
  - `id` string, uuid, required
  - `email_address` string, required
  - `first_name` string, required
  - `last_name` string, required
  - `account_role` string, required
  - `is_deleted` boolean, required
  - `profile_picture` string, nullable
  - `profile_color` string, nullable

---

[API](https://skmtc.net/freeplay/apis/freeplay-api.md) · [All operations](https://skmtc.net/freeplay/apis/freeplay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/freeplay/freeplay-api/revisions/69c553220183/schema)