---
title: "Add Organization Member"
method: POST
path: "/api/platform/organizations/{org_id}/members"
tags: ["platform"]
---

# Add Organization Member

`POST /api/platform/organizations/{org_id}/members`

Add an existing Auth0 user to an organization.

Requires ``editor`` on the ``members-organizations`` module instance (derived from the
POST method by the parent router gate). The user must already exist in the
connected Auth0 tenant; they are added to the organization in both Auth0
(the source of truth) and FGA, and the resolved user record is returned.
Use ``POST /api/platform/users`` instead to provision a brand-new user.

## Path parameters

- `org_id` string, required

## Request body

- AddOrganizationMemberRequest — Operator-supplied payload for adding an *existing* Auth0 user to an org. Distinct from :class:`app.platform.users.models.CreatePlatformUserRequest`, which provisions a brand-new Auth0 user. Here the ``userId`` must already exist in the connected tenant; the service resolves it, adds the membership in Auth0 (the source of truth), and mirrors the matching ``user → member → organization`` tuple into FGA.
  - `userId` string, required

## Response `201`

Successful Response

- User — A single user in the connected Auth0 tenant. Identity-only: organization and group memberships are looked up on demand via :class:`UserMembership` so listing pages don't pay for an FGA scan that only the detail pane will read. When multiple Auth0 users share one verified email they are collapsed into one row; ``linked_subs`` lists every Auth0 ``user_id`` for that person.
  - `userId` string, required
  - `email` string, nullable
  - `name` string, nullable
  - `picture` string, nullable
  - `loginCount` integer
  - `lastLogin` string, nullable
  - `createdAt` string, nullable
  - `linkedSubs` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/gocrisp/apis/crisp-app-dock.md) · [All operations](https://skmtc.dev/gocrisp/apis/crisp-app-dock/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gocrisp/crisp-app-dock/revisions/e56bd3c1a9db/schema)