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

# Create invitations

`POST /invitations/`

Invite the given email addresses, skipping ones already invited or registered.

## Query parameters

- `cookie_name` string, nullable

## Request body

- InvitationIn
  - `emails` string[], required — Email addresses to invite; already-invited or existing users are skipped.
  - `tenant_id` integer, nullable — Tenant to invite into; defaults to the caller's tenant.
  - `project_id` integer, nullable — Optional project to grant the invitees access to.
  - `admin` boolean, nullable — Whether invitees should be granted tenant admin privileges.

## Response `201`

Successful Response

- InvitationOut[]
  - `id` integer, required — Unique identifier of the invitation.
  - `email` string, required — Email address the invitation was sent to.
  - `tenant_id` integer, required — Identifier of the tenant the invite belongs to.
  - `project_id` integer, nullable, required — Project the invite grants access to, if any.
  - `status` string, required — Current invitation status.
  - `created_at` string, date-time, required — UTC timestamp when the invitation was created.
  - `accepted_at` string, date-time, nullable, required — UTC timestamp when the invitation was accepted, if it was.
  - `revoked_at` string, date-time, nullable, required — UTC timestamp when the invitation was revoked, if it was.
  - `creator_user_id` integer, required — Identifier of the user who created the invitation.

## Other responses

- `401` — Missing or invalid authentication.
- `403` — Tenant admin or project owner privileges required.
- `404` — The target tenant or project does not exist.
- `422` — Validation Error

---

[API](https://skmtc.net/neulandai/apis/neuland-ai-hub-api.md) · [All operations](https://skmtc.net/neulandai/apis/neuland-ai-hub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neulandai/neuland-ai-hub-api/revisions/b53e89b98c2b/schema)