# Invite a member

`POST /v1/orgs/{org}/members`

**In this build:** Uses a stand-in for an external service. The record is real. No invitation email is sent until a mail provider is connected.

**Scope:** `account.admin`

**CLI:** `harebox org invite`

Send an `Idempotency-Key` header. A retry with the same key never repeats the action.

## Request: `InviteMemberRequest`

| Field | Type | Notes |
|---|---|---|
| `email` (required) | `string` |  |
| `role` (required) | `string` | One of: `admin`, `developer`, `billing`, `viewer` |

## Response: 201

`Member`

| Field | Type | Notes |
|---|---|---|
| `id` (required) | `string` |  |
| `email` | `string` |  |
| `role` (required) | `string` | One of: `owner`, `admin`, `developer`, `billing`, `viewer` |
| `caps` | `MemberCaps` |  |

Errors follow [one format](../errors.html).