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

# Create Invitation

`POST /api/v1/admin/invitations/create`

## Request

- Base URL: `https://app.perlucem.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.perlucem.ai/api/v1/admin/invitations/create`
- Auth: HTTP bearer

Create a new user invitation.

For super admin invitations (is_super_admin=True):
- Only super_admin level users can create these
- rssd_id and bank_name are not required
- Invitee becomes a Perlucem staff admin

For bank user invitations (is_super_admin=False):
- rssd_id and bank_name are required
- Invitee gets access to the specified bank

## Request body

- CreateInvitationRequest: Request to create a new user invitation
  - `email` string, email, required
  - `rssd_id` string, nullable
  - `bank_name` string, nullable
  - `is_super_admin` boolean
  - `expiry_days` integer

## Response `200`

Successful Response

- InvitationResponse: Invitation details
  - `id` string, required
  - `email` string, required
  - `rssd_id` string, nullable
  - `bank_name` string, nullable
  - `invitation_token` string, required
  - `invitation_url` string, required
  - `status` string, required
  - `invited_by` string, required
  - `invited_at` string, required
  - `expires_at` string, required
  - `is_super_admin_invite` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/perlucem/apis/perlucem-ai-backend.md) · [All operations](https://skmtc.dev/perlucem/apis/perlucem-ai-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/perlucem/apis/perlucem-ai-backend/revisions/e1830fb27394?raw)