---
title: "Invite a person to an account"
method: POST
path: "/v1/users/{userID}/members"
---

# Invite a person to an account

`POST /v1/users/{userID}/members`

## Request

- Base URL: `https://api.plori.ai`
- URL: `https://api.plori.ai/v1/users/{userID}/members`
- Auth: HTTP bearer

Only the authenticated account owner can use this route. Members use their own credentials and cannot manage another account. The invitee signs in with the invited email. Invitations expire after seven days.

## Path parameters

- `userID` string, uuid, required

## Request body

- object
  - `email` string, email, required
  - `role` 'member' | 'viewer', required

## Response `201`

Invitation created and emailed.

- AccountMember
  - `id` string, uuid, required
  - `email` string, required
  - `role` 'member' | 'viewer', required
  - `state` 'invited' | 'active', required
  - `invited_at` string, date-time, required
  - `invite_expires_at` string, date-time
  - `accepted_at` string, date-time
  - `member_user_id` string, uuid
  - `monthly_spend_limit_micro_usd` integer, required: Monthly cap in micro-US-dollars. Zero means no member cap.

## Other responses

- `400`: Malformed request.
- `401`: Missing or invalid credential.
- `403`: The resource belongs to another account.
- `404`: No such resource.
- `409`: The account cannot invite itself, or the email already has an invitation or membership.
- `500`: Internal error with request_id.

---

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