---
title: "Invite a user to the current organization by email"
method: POST
path: "/api/rest/v1/pending-organization-users"
tags: ["Organization Users"]
---

# Invite a user to the current organization by email

`POST /api/rest/v1/pending-organization-users`

## Request

- Base URL: `https://app.componecat.ai`
- URL: `https://app.componecat.ai/api/rest/v1/pending-organization-users`
- Auth: none required

## Request body

- AddPendingOrganizationUserRequest: Request body for inviting a user to the current organization by email.
  - `email` string, required
  - `role` string, required

## Response `201`

Created

- OrganizationUserResource: An organization member as returned by the REST endpoints. A pending invitation has a null Guid? OrganizationUserResource.Id and DateTimeOffset? OrganizationUserResource.CreatedAt and a `PENDING`string OrganizationUserResource.Status.
  - `id` string, uuid, nullable, required
  - `email` string, nullable, required
  - `firstName` string, nullable, required
  - `lastName` string, nullable, required
  - `imageUrl` string, nullable, required
  - `role` string, required
  - `status` string, required
  - `createdAt` string, date-time, nullable, required
  - `membershipCreatedAt` string, date-time, required

---

[API](https://skmtc.dev/componecat/apis/componecat-rest-api.md) · [All operations](https://skmtc.dev/componecat/apis/componecat-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/componecat/apis/componecat-rest-api/revisions/6c53d4984720?raw)