---
title: "Invite somebody"
method: POST
path: "/v1/members/invitations"
tags: ["Team"]
---

# Invite somebody

`POST /v1/members/invitations`

## Request

- Base URL: `https://www.chatrail.dev`
- URL: `https://www.chatrail.dev/v1/members/invitations`
- Auth: API key in cookie `chatrail_session`

Emails a single-use link bound to that address. The token is never returned in the response. Nobody may invite to a role above their own.

## Request body

- object
  - `email` string, email, required
  - `role` 'owner' | 'admin' | 'developer' | 'viewer' | 'billing', required

## Response `201`

Invited.

## Other responses

- `402`: Member management is not on this plan.
- `403`: You cannot assign that role.
- `409`: Already a member.

---

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