---
title: "Create new user and add to enitty"
method: POST
path: "/entities/{entity_id}/users"
---

# Create new user and add to enitty

`POST /entities/{entity_id}/users`

This endpoint creates a new user and associates to the passed in entity

## Path parameters

- `entity_id` string, required

## Request body

- object
  - `fname` string, required — First name of the new user. Whitespace is stripped.
  - `lname` string, required — Last name of the new user. Whitespace is stripped.
  - `assigned_advisor_id` integer, required — ID of a firm user to assign as the client's advisor. Must belong to the authenticated firm.
  - `phone_number` string — Personal phone number.
  - `work_phone_number` string — Work phone number.
  - `work_phone_extension` string — Work phone extension.
  - `preferred_contact_method` string — Preferred contact method (e.g. "email", "sms").
  - `time_zone` string — IANA time zone name. Defaults to the firm's time zone if omitted.
  - `external_user_id` string — Caller-supplied external identifier for the user.

## Response `200`

- object
  - `user` object
    - `id` integer
    - `email` string
    - `fname` string
    - `lname` string
    - `full_name` string
    - `time_zone` string
    - `phone_number` string
    - `preferred_name` string
    - `created_at` string
    - `active` boolean
    - `assigned_advisor_id` integer
    - `work_phone_number` string
    - `work_phone_extension` string
    - `work_email` string
    - `external_user_id` string
    - `assigned_advisor` string
    - `entities` object[]
      - `entity_id` integer
      - `entity_name` string
      - `entity_type` string
      - `external_entity_id` string
      - `role` string
      - `firm_role_id` integer
      - `tags` object[]
        - `id` string
        - `name` string
  - `entity` object
    - `id` integer
    - `entity_type` string
    - `name` string
    - `street` string
    - `state` string
    - `city` string
    - `zip` string
    - `country` string
    - `tax_return_name` string
    - `created_at` string
    - `upload_link` string
    - `business_email` string
    - `other_email` string
    - `external_entity_id` string
    - `deleted_at` string
    - `hash_id` string
    - `inactive` boolean
    - `tags` object[]
      - `id` integer
      - `name` string
    - `user` object
      - `id` integer
      - `email` string
      - `fname` string
      - `lname` string
      - `full_name` string
      - `time_zone` string
      - `phone_number` string
      - `preferred_name` string
      - `created_at` string
      - `active` boolean
      - `assigned_advisor_id` integer
      - `work_phone_number` string
      - `work_phone_extension` string
      - `work_email` string
      - `external_user_id` string
      - `assigned_advisor` string
      - `entities` object[]
        - `entity_id` integer
        - `entity_name` string
        - `entity_type` string
        - `external_entity_id` string
        - `role` string
        - `firm_role_id` string
        - `tags` object[]
          - `id` integer
          - `name` string
    - `owners` object[]

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/soraban/apis/soraban-private-api.md) · [All operations](https://skmtc.net/soraban/apis/soraban-private-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/soraban/soraban-private-api/versions/0dfdfa10c993/schema)