---
title: "Create a new entity"
method: POST
path: "/entities"
---

# Create a new entity

`POST /entities`

## Request body

- EntityCreate
  - `name` string, required
  - `street` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `country` string, nullable
  - `zip` string, nullable
  - `entity_type` 'Individual' | 'Partnership' | 'Corporation' | 'Trust' | 'Estate' | 'Other', required
  - `user_id` integer, required
  - `business_email` string, nullable
  - `other_email` string, nullable

## Response `200`

Entity created

- Entity
  - `id` integer, required
  - `entity_type` string, required
  - `name` string, required
  - `street` string, nullable
  - `state` string, nullable
  - `city` string, nullable
  - `zip` string, nullable
  - `country` string, nullable
  - `tax_return_name` string, required
  - `created_at` string, date-time, required
  - `upload_link` string, uri, required
  - `user` Client, required
    - `id` integer, required
    - `email` string, email, required
    - `fname` string, required
    - `lname` string, required
    - `full_name` string, nullable
    - `time_zone` string, nullable
    - `phone_number` string, nullable
    - `preferred_name` string, nullable
    - `created_at` string, date-time, required
    - `active` boolean, required — Derived from User#paying
    - `assigned_advisor_id` integer, required
    - `work_phone_number` string, nullable
    - `work_phone_extension` string, nullable
    - `work_email` string, email, nullable
    - `external_user_id` string, nullable
    - `assigned_advisor` string, nullable — Assigned advisor full name (string), not an object
  - `business_email` string, nullable
  - `other_email` string, nullable
  - `owners` Client[], required — Owners resolved from owner_ids; serialized as clients
    - `id` integer, required
    - `email` string, email, required
    - `fname` string, required
    - `lname` string, required
    - `full_name` string, nullable
    - `time_zone` string, nullable
    - `phone_number` string, nullable
    - `preferred_name` string, nullable
    - `created_at` string, date-time, required
    - `active` boolean, required — Derived from User#paying
    - `assigned_advisor_id` integer, required
    - `work_phone_number` string, nullable
    - `work_phone_extension` string, nullable
    - `work_email` string, email, nullable
    - `external_user_id` string, nullable
    - `assigned_advisor` string, nullable — Assigned advisor full name (string), not an object
  - `external_entity_id` string, nullable
  - `deleted_at` string, date-time, nullable
  - `hash_id` string, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden

---

[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)