# Invite a new member to the organization

`POST /api/v1/members/invitations`

Creates a pending invitation for an email with the given role. Admin only. Fails if the email already belongs to a member or already has a pending invitation.

**Request body** (application/json)

| Field   | Type   | Required | Description                                                                                                                                                                                                    |
| ------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `email` | string | yes      |                                                                                                                                                                                                                |
| `role`  | string | yes      | Organization role. admin: manage members and billing, plus everything readwrite can do. readwrite: start sessions, create API keys, delete sessions. readonly: view sessions, API keys, and test results only. |

**Example request**

```
curl https://api.mobilenexthq.com/api/v1/members/invitations \

  -X POST \

  -H 'Authorization: Bearer mob_...' \

  -H 'Content-Type: application/json' \

  -d '{"email":"string","role":"admin"}'
```

**Responses**

**201** — Invitation created

```
{

  "id": "string",

  "email": "string",

  "role": "admin",

  "status": "pending",

  "invitedByUserId": "string",

  "createdAt": "2026-01-01T00:00:00Z",

  "expiresAt": "2026-01-01T00:00:00Z"

}
```

**400** — Invalid request body

```
{

  "error": {

    "code": "string",

    "message": "string"

  }

}
```

**401** — Missing or invalid Bearer token

```
{

  "error": {

    "code": "string",

    "message": "string"

  }

}
```

**403** — Caller lacks permission for this action (e.g. not an admin)

```
{

  "error": {

    "code": "string",

    "message": "string"

  }

}
```

**409** — Request conflicts with current state (e.g. already a member or already invited)

```
{

  "error": {

    "code": "string",

    "message": "string"

  }

}
```