---
title: "Create invitation"
method: POST
path: "/orgmng/invitations"
tags: ["Organization Invitations"]
---

# Create invitation

`POST /orgmng/invitations`

## Request

- Base URL: `http://localhost:8486`
- URL: `http://localhost:8486/orgmng/invitations`
- Auth: API key in header `x-auth-token`

## Request body

- CreateInvitationDTO
  - `email` string, required
  - `roles` string[], required
  - `organizationId` integer

## Response `201`

Created

- InvitationDTO
  - `id` integer
  - `organizationId` integer
  - `inviterUserId` integer
  - `email` string
  - `roles` string[]
  - `status` 'PENDING' | 'ACCEPTED' | 'CANCELLED' | 'EXPIRED' | 'REJECTED'
  - `expiresAt` string, date-time
  - `acceptedUserId` integer
  - `createdAt` string, date-time

## Other responses

- `400`: Validation error
- `409`: Conflict

---

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