---
title: "Invite Member"
method: POST
path: "/portal/members"
tags: ["portal"]
---

# Invite Member

`POST /portal/members`

## Request

- Base URL: `https://api.b2metric.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.b2metric.com/portal/members`
- Auth: none declared

Owner invites a teammate into their OWN tenant. Creates a directly-usable
Keycloak login (permanent password, no required actions) and adds it to the
tenant group. No role input — the member gets the realm default role only, so
an owner can never mint a platform-admin/owner.

## Query parameters

- `tenant` string, nullable: legacy alias of X-B2M-Tenant

## Headers

- `authorization` string, nullable

## Request body

- MemberInvite: Owner-scoped member invite: creates a directly-usable login (permanent password, no required actions) in the owner's OWN tenant group. No role input — members get the realm default role only (owners can't mint admins).
  - `email` string, required
  - `first_name` string, required
  - `last_name` string, required
  - `username` string, nullable
  - `password` string, nullable

## Response `201`

Successful Response

- AppSchemasUserInviteOut
  - `id` string, required
  - `invite` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/b2metric/apis/b2metric-license-api.md) - [All operations](https://skmtc.dev/b2metric/apis/b2metric-license-api/llms.txt) - [OpenAPI document](https://skmtc.dev/b2metric/apis/b2metric-license-api/revisions/5c26e11e8b53?raw)