---
title: "Create a shareable JOIN code (org_admin). It always expires: `expiresAt` or `expiresInDays`, default 14 days, at most 365"
method: POST
path: "/api/orgs/{orgId}/invite-codes"
tags: ["invites"]
---

# Create a shareable JOIN code (org_admin). It always expires: \`expiresAt\` or \`expiresInDays\`, default 14 days, at most 365

`POST /api/orgs/{orgId}/invite-codes`

## 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}/invite-codes`
- Auth: none declared

## Path parameters

- `orgId` string, required

## Request body

- CreateInviteCodeBody
  - `maxUses` integer
  - `expiresAt` string, date-time
  - `expiresInDays` integer
  - `role` 'org_admin' | 'member'
  - `groups` string[]

## Response `201`

Created.

- object
  - `id` string, required
  - `orgId` string, required
  - `code` string, required
  - `role` 'org_admin' | 'member'
  - `groupIds` string[]
  - `maxUses` integer
  - `uses` integer
  - `expiresAt` string, date-time
  - `revokedAt` string, date-time
  - `createdBy` string, required
  - `createdAt` string, date-time, required

## Other responses

- `403`: Insufficient role.

---

[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)