---
title: "Invite by e-mail or phone (identifier-keyed, one-shot) and tell them: an e-mail, or a WhatsApp / SMS for a phone, with a personal sign-in link (`send: false` = create only); or attach an existing principal"
method: POST
path: "/api/orgs/{orgId}/people"
tags: ["people"]
---

# Invite by e-mail or phone (identifier-keyed, one-shot) and tell them: an e-mail, or a WhatsApp / SMS for a phone, with a personal sign-in link (\`send: false\` = create only); or attach an existing principal

`POST /api/orgs/{orgId}/people`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/orgs/{orgId}/people`
- Auth: none declared

## Path parameters

- `orgId` string, required

## Request body

- AddPersonBody
  - `email` string, email
  - `phone` string
  - `mode` 'invite' | 'active'
  - `displayName` string
  - `role` 'org_admin' | 'member'
  - `groups` string[]
  - `send` boolean
  - `lang` 'he' | 'en' | 'pt'
  - `confirm` boolean: false = return a preview only; true = apply the change.

## Response `200`

Preview or result.

- union
  - Preview
    - `preview` object, required
  - Applied
    - `applied` object, required

## Other responses

- `403`: Insufficient role.
- `409`: Phone belongs to another account.

---

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