---
title: "Create Invite"
method: POST
path: "/api/organizations/{organization_id}/invites"
tags: ["organizations"]
---

# Create Invite

`POST /api/organizations/{organization_id}/invites`

## Request

- Base URL: `https://api.maritime.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maritime.sh/api/organizations/{organization_id}/invites`
- Auth: HTTP bearer

Invite one email. Sends the link by email, or returns it when email is off.

## Path parameters

- `organization_id` string, required

## Request body

- InviteCreate
  - `email` string, required
  - `role` string

## Response `201`

Successful Response

- InviteResponse
  - `id` string, required
  - `email` string, required
  - `role` string, required
  - `invitedBy` string, required
  - `invitedByName` string, nullable
  - `createdAt` string, date-time, required
  - `expiresAt` string, date-time, required
  - `link` string, nullable

## Other responses

- `422`: Validation Error

---

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