> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an entity

> Create a new legal entity in your Plane workspace.

Use this endpoint to register an additional legal entity in your workspace,
for example a subsidiary or a second operating company. Only the legal name is
required to start; you can complete the remaining business details later with
[Update an entity](/reference/entities/update).

### Parameters

<ParamField body="name" type="string" required>
  The legal name of the entity as registered with government authorities.
</ParamField>

<ParamField body="country" type="string">
  Two-letter ISO country code (ISO 3166-1 alpha-2) where the entity is legally domiciled.
</ParamField>

<ParamField body="address" type="object">
  The primary business address of the entity.

  <Expandable title="child attributes">
    <ResponseField name="line1" type="string" required>
      Address line1 (e.g. street or company name).
    </ResponseField>

    <ResponseField name="line2" type="string">
      Address line2 (e.g. apartment, suite, unit or building).
    </ResponseField>

    <ResponseField name="city" type="string" required>
      City, district, suburb, town, or village.
    </ResponseField>

    <ResponseField name="state" type="string" required>
      State, county, province, or region.
    </ResponseField>

    <ResponseField name="postal_code" type="string" required>
      ZIP or postal code.
    </ResponseField>

    <ResponseField name="country" type="string" required>
      Two-letter country code (ISO 3166-1 alpha-2).
    </ResponseField>
  </Expandable>
</ParamField>

<ParamField body="dba" type="string">
  "Doing Business As" name - the trade name used by the entity if different from the legal name.
</ParamField>

<ParamField body="description" type="string">
  A brief description of the entity's business activities or purpose.
</ParamField>

<ParamField body="email" type="string">
  Primary contact email address for the entity.
</ParamField>

<ParamField body="phone" type="string">
  Primary contact phone number for the entity.
</ParamField>

<ParamField body="website" type="string">
  The entity's primary website URL.
</ParamField>

<ParamField body="structure" type="string">
  The legal structure of the entity. Allowed values are `corporation`, `llc`, or `partnership`.
</ParamField>

<ParamField body="formation" type="object">
  Details about the entity's legal formation.

  <Expandable title="child attributes">
    <ResponseField name="country" type="string">
      Two-letter country code (ISO 3166-1 alpha-2) where the entity was formed.
    </ResponseField>

    <ResponseField name="state" type="string">
      The state or jurisdiction where the entity was formed.
    </ResponseField>

    <ResponseField name="date" type="string">
      The date when the entity was legally formed or incorporated (`YYYY-MM-DD`).
    </ResponseField>
  </Expandable>
</ParamField>

<ParamField body="tax_id" type="object">
  Tax identification information for the entity. Write-only: never returned in API responses.

  <Expandable title="child attributes">
    <ResponseField name="number" type="string" required>
      The tax identification number (e.g. EIN in the US).
    </ResponseField>

    <ResponseField name="country" type="string" required>
      Two-letter country code for the jurisdiction that issued the tax ID.
    </ResponseField>

    <ResponseField name="type" type="string">
      The type of tax ID (e.g. `ein`).
    </ResponseField>
  </Expandable>
</ParamField>

<ParamField body="metadata" type="object">
  Arbitrary key-value data to attach to the entity.
</ParamField>

### Returns

Returns the created [Entity object](/reference/entities/object).

<ResponseExample>
  ```json Request theme={null}
  {
    "name": "Acme Labs LLC",
    "country": "US",
    "structure": "llc",
    "email": "labs@acmecorp.com",
    "address": {
      "line1": "548 Market Street",
      "line2": null,
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94104",
      "country": "US"
    }
  }
  ```

  ```json Response theme={null}
  {
    "id": "ent_kP9r2NqW6mT4s1Bc",
    "object": "entity",
    "workspace": "wsp_Xb2fPlgnLc",
    "name": "Acme Labs LLC",
    "country": "US",
    "address": {
      "line1": "548 Market Street",
      "line2": null,
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94104",
      "country": "US"
    },
    "status": "unverified",
    "dba": null,
    "description": null,
    "email": "labs@acmecorp.com",
    "phone": null,
    "website": null,
    "structure": "llc",
    "formation": null,
    "metadata": {},
    "created": "2026-05-27T12:00:00Z",
    "updated": "2026-05-27T12:00:00Z"
  }
  ```
</ResponseExample>