---
title: "Create Organization Invitation"
method: POST
path: "/admin/organizations/{org_id}/invitations"
tags: ["admin", "admin:organizations"]
---

# Create Organization Invitation

`POST /admin/organizations/{org_id}/invitations`

## Request

- Base URL: `https://platform.tracecat.com/api`
- URL: `https://platform.tracecat.com/api/admin/organizations/{org_id}/invitations`
- Auth: API key in cookie `fastapiusersauth`

Create a platform-scoped invitation for an organization.

## Path parameters

- `org_id` string, uuid, required

## Request body

- AdminOrgInvitationCreate: Create an organization invitation from the platform admin console.
  - `email` string, email, required
  - `role_slug` 'organization-owner' | 'organization-admin' | 'organization-member'

## Response `201`

Successful Response

- AdminOrgInvitationCreateResponse: Create response containing the raw invitation token.
  - `id` string, uuid, required
  - `organization_id` string, uuid, required
  - `email` string, email, required
  - `role_id` string, uuid, required
  - `role_name` string, required
  - `role_slug` string, nullable
  - `status` 'pending' | 'accepted' | 'revoked', required: Invitation lifecycle status.
  - `invited_by` string, uuid, nullable, required
  - `expires_at` string, date-time, required
  - `created_at` string, date-time, required
  - `accepted_at` string, date-time, nullable, required
  - `created_by_platform_admin` boolean, required
  - `last_emailed_at` string, date-time, nullable
  - `token` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tracecat/apis/tracecat-api.md) - [All operations](https://skmtc.dev/tracecat/apis/tracecat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tracecat/apis/tracecat-api/revisions/2efdda25045f?raw)