---
title: "Create User"
method: POST
path: "/scim/v1/organizations/{organization_id}/Users/"
tags: ["SCIM"]
---

# Create User

`POST /scim/v1/organizations/{organization_id}/Users/`

## Request

- Base URL: `https://api.proof.com`
- URL: `https://api.proof.com/scim/v1/organizations/{organization_id}/Users/`
- Auth: API key in header `ApiKey`

## Path parameters

- `organization_id` string, required

## Request body

- UserCreationParams
  - `userName` string, required: Email address as username.
  - `name` object
    - `givenName` string: The first name of the user
    - `familyName` string: The last name of the user
  - `emails` object[]: List of user emails, only primary supported
    - `value` string: user primary email
  - `roles` object[]: List of user roles, only primary supported. One of “owner”, “admin” or “employee”
    - `value` string: user role
  - `externalId` string: This identifier is generateda by the SAML provider, and is used as a unique ID by the SAML provider to match against a Proof user
  - `active` boolean: Used to indicate whether the identity is active (true) or deprovisioned (false).

## Response `201`

Successful

## Other responses

- `400`: Bad Request
- `401`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/proof/apis/scim-api-specification.md) - [All operations](https://skmtc.dev/proof/apis/scim-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/proof/apis/scim-api-specification/revisions/4db32de113a7?raw)