---
title: "Create a business entity"
method: POST
path: "/entities/businesses"
tags: ["Entities"]
---

# Create a business entity

`POST /entities/businesses`

Creates a business entity

## Request body

- object
  - `external_entity_id` string
  - `business_name` string
  - `business_alternate_name` string
  - `business_registry_id` string
  - `business_federal_ein` string
  - `addresses` object[]
  - `emails` object[]
    - `email_address` string
  - `phones` object[]
    - `phone_number` string
  - `pii_status` 'successful' | 'failed' | 'pending'

## Response `201`

Entity

- object
  - `status_code` string
  - `entity_token` string
  - `external_entity_id` string
  - `created_at` number
  - `business_name` string
  - `business_alternate_name` string
  - `business_registry_id` string
  - `business_federal_ein` string
  - `addresses` object[]
  - `emails` object[]
    - `email_address` string
  - `phones` object[]
    - `phone_number` string
  - `entity_groups` Items[] — unresolved $ref
  - `type` string
  - `_embedded` object
    - `notes` Items[] — unresolved $ref
    - `external_entity_ids` Items[] — unresolved $ref
  - `_links` Links — unresolved $ref

## Other responses

- `400` — Missing required fields

---

[API](https://skmtc.dev/alloy/apis/alloy-api.md) · [All operations](https://skmtc.dev/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alloy/alloy-api/revisions/405799de4d2a/schema)