---
title: "Create Organization Invitations"
method: POST
path: "/v1/organization/invitations"
tags: ["Organization Invitations"]
---

# Create Organization Invitations

`POST /v1/organization/invitations`

## Request

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

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

## Request body

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

## Response `200`

- ListInvitationsResponse
  - `success` boolean, required: Indicates if the request was successful
  - `data` object, required
    - `invitations` Invitation[]: List of organization 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
      - `organizationRoleId` string, nullable: The id of the organization role the invitee will receive, or `null` for the default

## Changes

> 54 revisions in range; 3 not diffed.

- **2026-05-31** `173563ada468`: 2 info
  - api tag `Organization Invitations` added
  - api tag `Invitations` removed
- **2026-05-31** `78a7dd1b6b48`: 1 info
  - endpoint added
- **2026-05-31** `d493eef38a58`: 1 breaking
  - api path removed without deprecation
- **2026-05-31** `78a7dd1b6b48`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/confident-ai/apis/confident-ai-metrics-api/changes/v1/organization/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)