---
title: "Create Project Invitations"
method: POST
path: "/v1/projects/{projectId}/invitations"
tags: ["Project Invitations"]
---

# Create Project Invitations

`POST /v1/projects/{projectId}/invitations`

## Request

- Base URL: `https://api.confident-ai.com`
- URL: `https://api.confident-ai.com/v1/projects/{projectId}/invitations`
- Auth: none declared
- TypeScript: <https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/docs/v1/projects/:projectId/invitations/post.ts> (a function with typed inputs; its response is checked against the schema)

Invites one or more users to a project by email. Emails that are already members or already invited are skipped. Optionally assign a project role to the invitees — the `Owner` role cannot be assigned. Inviting members is not available on the Free plan outside of the trial period.

## Path parameters

- `projectId` string, required

## Request body

- CreateProjectInvitations
  - `emails` string[], required: One or more email addresses to invite
  - `projectRoleId` string, uuid: Optional project role id to assign to all invitees. The `Owner` role cannot be assigned.

## Response `200`

- ListProjectInvitationsResponse
  - `success` boolean, required: Indicates if the request was successful
  - `data` object, required
    - `invitations` ProjectInvitation[]: List of project invitations
      - `id` integer, required: Unique identifier for the invitation
      - `email` string, required: The invited email address
      - `status` 'PENDING' | 'ACCEPTED' | 'DECLINED', required: The current status of the invitation
      - `created_at` string, date-time, required: ISO 8601 timestamp of when the invitation was created
      - `projectRoleId` string, nullable: The id of the project role the invitee will receive, or `null` for the default

## Changes

> 54 revisions in range; 3 not diffed.

- **2026-05-31** `173563ada468`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/changes/v1/projects/:projectId/invitations/post.md)

---

[API](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api.md) - [All operations](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/revisions/95cdde71b65e?raw)