---
title: "POST /accounts/organization/invite/"
method: POST
path: "/accounts/organization/invite/"
tags: ["accounts"]
---

# POST /accounts/organization/invite/

`POST /accounts/organization/invite/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/accounts/organization/invite/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Create invites for one or more email addresses.
Also dual-writes to legacy User/membership records for backward compat.

## Request body

- InviteCreate
  - `emails` string[], required
  - `org_level` 15 | 8 | 3 | 1, required: Integer org level to grant (Owner=15, Admin=8, Member=3, Viewer=1).
  - `workspace_access` WorkspaceAccessInput[]: List of {"workspace_id": "<uuid>", "level": <int>}.
    - `workspace_id` string, uuid, required
    - `level` 8 | 3 | 1

## Response `200`

OK

- InviteCreateResponse
  - `status` boolean, required
  - `result` InviteCreateResult, required
    - `invited` string[], required
    - `already_members` string[]
    - `invites` InviteLink[]: Accept-invite links for the invites just created. Present on OSS deployments only, where SMTP may not be configured; omitted on Cloud/EE.
      - `email` string, email, required
      - `invite_link` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)