---
title: "Invite a teammate by email into the caller's org (owner/admin; owner role owner-only)"
method: POST
path: "/invites"
tags: ["invites"]
---

# Invite a teammate by email into the caller's org (owner/admin; owner role owner-only)

`POST /invites`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/invites`
- Auth: none declared

## Request body

- CreateInviteRequest
  - `email` string, email, required
  - `role` 'owner' | 'admin' | 'member', nullable, required

## Response `200`

Invite created + emailed

- Invite
  - `id` string, required
  - `email` string, email, required
  - `role` 'owner' | 'admin' | 'member', nullable, required
  - `orgId` string, required
  - `status` 'pending' | 'accepted' | 'revoked' | 'expired', required
  - `invitedByUserId` string, nullable, required
  - `expiresAtSec` integer, required
  - `createdAt` integer, required

## Other responses

- `401`: Unauthenticated
- `403`: Role insufficient
- `429`: Rate limited
- `502`: Invite email failed

---

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