---
title: "Send an invitation email to a new teammate (admin + manager)"
method: POST
path: "/api/me/team/invite"
tags: ["me"]
---

# Send an invitation email to a new teammate (admin + manager)

`POST /api/me/team/invite`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/me/team/invite`
- Auth: none declared

Force-reinvites by canceling any prior pending invite for the same (customer, email). Manager cannot grant admin role; CHECK constraint at the DB + Zod enum here enforce role ∈ {user, manager}.

## Request body

- InviteBody
  - `email` string, email, required
  - `role` 'user' | 'manager' | 'prospector', required

## Response `201`

Invite created

- InviteResponse
  - `inviteId` string, uuid, required
  - `email` string, email, required
  - `role` 'user' | 'manager' | 'prospector', required
  - `expiresAt` string, date-time, required

## Other responses

- `400`: Validation error / invalid email
- `403`: Insufficient role (user-role denied)

---

[API](https://skmtc.dev/signalraven/apis/zygnal-api.md) · [All operations](https://skmtc.dev/signalraven/apis/zygnal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalraven/apis/zygnal-api/revisions/36e1d9b9d604?raw)