---
title: "Add Company User"
method: POST
path: "/settings/user/add"
tags: ["settings"]
---

# Add Company User

`POST /settings/user/add`

Validate and add a single user to the company.

- Validates email domain against company domains or non-personal domains
- Ensures user does not already exist
- Validates provided role_id is allowed (company role or global full_user)
- Sends welcome email asynchronously (best-effort)

## Request body

- UserWithRoleID
  - `first_name` string, required
  - `last_name` string, required
  - `email_address` string, email, required
  - `role_id` string, uuid, nullable
  - `marketing_team_id` string, uuid, nullable
  - `assignments` RoleAssignment[], nullable
    - `module` string, required
    - `role_id` string, uuid, nullable

## Response `200`

Successful Response

- NewUserResponse — Response body for new user creation.
  - `status` string, required
  - `user` UserResponse, required
    - `user_id` string, uuid, required
    - `user_first_name` string, required
    - `user_last_name` string, required
    - `email_address` string, required
    - `company_id` string, uuid, required
    - `profile_picture_url` string, nullable
    - `masquerade_status` MasqueradeStatus
      - `mode` 'soft' | 'hard', required
      - `target_company_id` string, uuid, required
      - `target_company_name` string, required
    - `whats_new_last_viewed_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kobaltlabs/apis/fastapi.md) · [All operations](https://skmtc.dev/kobaltlabs/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kobaltlabs/fastapi/revisions/425d5b8a3c17/schema)