---
title: "Invite a teammate into a seat"
method: POST
path: "/v1/team/invites"
tags: ["Team"]
---

# Invite a teammate into a seat

`POST /v1/team/invites`

## Request

- Base URL: `https://api.briefgate.dev`
- URL: `https://api.briefgate.dev/v1/team/invites`
- Auth: HTTP bearer

Owner-only — a member gets 403. Emails the address a one-time, hashed link that expires in 7 days and self-serves account creation (see POST /v1/team/invites/accept).

**Seat quota (`quota_exceeded`, 402):** the plan's seat count is checked against `members + pending (unaccepted, unexpired) invites`, not just current members. An account on a 3-seat plan with 1 owner and 2 outstanding invites is already at its limit even though only one `users` row exists — a pending invite reserves the seat it would fill so the limit cannot be worked around by inviting faster than people accept. Cancel a pending invite (DELETE /v1/team/invites/{id}) or remove a member to free a slot.

Rate limited to 20 invitations per account per hour (`rate_limited`, 429, `Retry-After` header) — this bounds accidental or abusive mass-invites, not normal team growth.

Inviting an address that is already a member of this account returns `invalid_request` (400). Sending a second invite to the same still-pending address replaces the first one — the earlier link stops working.

## Request body

- InviteTeamMember
  - `email` string, email, required

## Response `201`

Invitation created and emailed

- object
  - `id` string
  - `email` string, email
  - `role` 'member'
  - `created_at` string, date-time
  - `expires_at` string, date-time

## Other responses

- `400`: Invalid request — malformed body or query parameters
- `401`: Missing or invalid API key
- `402`: The account's plan does not include this — `plan_required` — or a quota is exhausted
- `403`: Authenticated but not allowed to perform this action
- `422`: Validation error — the body shape is correct but values are invalid
- `429`: Rate limit exceeded

---

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