---
title: "Creates a new service user."
method: POST
path: "/orgs/{orgId}/users"
tags: ["public", "UserProfile"]
---

# Creates a new service user.

`POST /orgs/{orgId}/users`

## Path parameters

- `orgId` string, required

## Request body

- NewServiceUserRequest — NewServiceUser holds the definition of a new service user.
  - `email` string — The email address that should get notifications about this service user. (Optional)
  - `name` string, required — The name that should be shown for this service user.
  - `role` string, required — The role that the service user should have on the organization it is created in

## Response `200`

The extended user profile of the user.

- UserProfileResponse — UserProfile holds the profile information of a user
  - `created_at` string, required — The time the user was first registered with Humanitec
  - `email` string — The email address of the user from the profile
  - `id` string, required — The User ID for this user
  - `name` string, required — The name the user goes by
  - `type` string, required — The type of the account. Could be user, service or system

## Other responses

- `400` — The request was invalid or the payload malformed.
- `403` — Token is not valid for a user.

---

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