---
title: "Create an invite"
method: POST
path: "/invites"
tags: ["Invites"]
---

# Create an invite

`POST /invites`

Invite a user to the workspace by email. If the user already has an Ordinal account, they will be added to the workspace immediately. Otherwise, an invite email will be sent.

## Request body

- CreateInviteInput
  - `email` string, email, required — The email address of the user to invite

## Response `200`

Invite created or user added to workspace

- object
  - `invite` Invite
    - `id` string, uuid — The unique identifier of the invite
    - `email` string, email — The email address of the invited user
    - `createdAt` string, date-time — When the invite was created
  - `sentEmail` boolean — Whether an invite email was sent

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Missing or invalid API key
- `403` — Forbidden - Insufficient permissions
- `409` — Conflict - Resource already exists

---

[API](https://skmtc.net/tryordinal/apis/ordinal-api.md) · [All operations](https://skmtc.net/tryordinal/apis/ordinal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryordinal/ordinal-api/versions/1d0792ff454f/schema)