---
title: "Create Admin Invitation"
method: POST
path: "/admin/invitations"
tags: ["admin"]
---

# Create Admin Invitation

`POST /admin/invitations`

## Request

- Base URL: `https://api.mengi.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mengi.cloud/admin/invitations`
- Auth: none declared

Invite a prospect by email into a new organization, an existing one,
or no organization at all (the invitee's personal account).

Trial credit (infra credit, platform fee waived until spent, no payment
mandate required) applies to the target's subscription: the org's, or the
invitee's personal one. New-org invites default to a €50 trial. The
response carries the invite URL exactly once — copy it if the email can't
be delivered.

## Request body

- AdminInvitationCreate
  - `email` string, required
  - `invitee_name` string, nullable
  - `organization_name` string, nullable
  - `organization_id` string, uuid, nullable
  - `role` 'owner' | 'admin' | 'member'
  - `trial_credit_eur` number, nullable
  - `expires_days` integer

## Response `200`

Successful Response

- AdminInvitationResponse
  - `id` string, uuid, required
  - `email` string, required
  - `invitee_name` string, nullable, required
  - `role` string, required
  - `organization_id` string, uuid, nullable, required
  - `organization_name` string, nullable, required
  - `organization_created` boolean
  - `trial_credit_eur` number, nullable, required
  - `status` string, required
  - `invited_by` string, nullable, required
  - `expires_at` string, date-time, required
  - `accepted_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `invite_url` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mengi/apis/mengi-cloud.md) · [All operations](https://skmtc.dev/mengi/apis/mengi-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/mengi/apis/mengi-cloud/revisions/4ae9b375cdbb?raw)