---
title: "Add a user to Organization"
method: POST
path: "/v1/organizations/{organizationId}/users"
tags: ["Organizations"]
---

# Add a user to Organization

`POST /v1/organizations/{organizationId}/users`

Add a new user to the organization or invite existing users. Assigns default roles and sends invitation emails as configured.

## Parameters

- `#/paths/~1v1~1organizations~1%7BorganizationId%7D/get/parameters/0` — unresolved $ref

## Request body

- object
  - `firstName` string
  - `lastName` string
  - `email` Email — unresolved $ref
  - `role` 'admin' | 'member' | 'readonly'
  - `password` string
  - `status` 'active' | 'inactive' | 'locked'
  - `authType` AuthType — unresolved $ref

## Response `201`

Added new user.

- object
  - `authType` AuthType — unresolved $ref
  - `email` Email — unresolved $ref
  - `firstName` string
  - `lastName` string
  - `id` Id — unresolved $ref
  - `lastActivity` string
  - `status` 'active' | 'inactive'
  - `systemRole` string
  - `roles` object[]
    - `id` Id — unresolved $ref
    - `orgSlug` Schema — unresolved $ref
    - `organizationId` Id — unresolved $ref
    - `role` string
    - `roleId` Id — unresolved $ref
    - `status` Status — unresolved $ref
    - `userId` Id — unresolved $ref
    - `orgName` string
  - `tokens` object[]
    - `id` Id — unresolved $ref
    - `userId` Id — unresolved $ref
    - `token` string — Truncated token value
    - `expiresAt` CreatedAt — unresolved $ref
    - `createdAt` CreatedAt — unresolved $ref
    - `createdBy` object
      - `id` Id — unresolved $ref
      - `firstName` string, John
      - `lastName` string, Snow
  - `password_history` object[]
  - `athenaCredentialsUpdatedAt` CreatedAt — unresolved $ref
  - `preferences` Preferences — unresolved $ref
  - `rowPreferences` Preferences — unresolved $ref

## Other responses

- `400` — Bad request, details in response.
- `401` — Invalid token
- `403` — Caller is not authorized to perform this action

---

[API](https://skmtc.net/tetrascience/apis/tetra-data-lake.md) · [All operations](https://skmtc.net/tetrascience/apis/tetra-data-lake/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tetrascience/tetra-data-lake/revisions/0205e2bace53/schema)