---
title: "Invites a user to an Organization with a specified role."
method: POST
path: "/orgs/{orgId}/invitations"
tags: ["public", "UserRole"]
---

# Invites a user to an Organization with a specified role.

`POST /orgs/{orgId}/invitations`

## Path parameters

- `orgId` string, required

## Request body

- UserInviteRequestRequest — UserInviteRequest describes a new user invitation.
  - `email` string, required — The email address of the user from the profile.
  - `role` string, required — The role that this user would hold.

## Response `200`

An temporary profile for the invited user.

- UserRoleResponse[]
  - `created_at` string, required — The time the user or the group was first registered with Humanitec
  - `email` string — The email address of the user from the profile
  - `id` string, required — The User or Group Id
  - `invite` string — The status of an invitation (If applicable)
  - `name` string, required — The name the User or Group goes by
  - `role` string, required — The role that this User or Group holds
  - `type` string, required — The type of the account. Could be user, service, group or system
  - `idp_id` string — The IdP id the group is registered for. Empty if user is not a group.

## Other responses

- `400` — The request was invalid or the payload malformed.
- `404` — Object does not exist.

---

[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)