---
title: "Create Entity"
method: POST
path: "/api/v1/admin/openbb/entities"
tags: ["Admin APIs", "openbb-entities"]
---

# Create Entity

`POST /api/v1/admin/openbb/entities`

Create a new OpenBB entity.

This also sets up default entitlements for the entity.

## Query parameters

- `idempotent` boolean — If True (default), return the existing entity when the name already matches one instead of creating a new one. Pass False to force a genuinely new entity even on a name collision — e.g. to remediate an existing entity that's missing default permission maps, since those are only bootstrapped by OpenBB Hub on real creation, not on an idempotent match.

## Request body

- OpenBBEntityCreate — Schema for creating a new OpenBB entity (organization).
  - `name` string, required — Entity name
  - `entity_type_uuid` string, required — UUID of the entity type
  - `email` string, email, required — Entity contact email
  - `admin_email` string, email, required — Primary admin email
  - `company_type` string, required — Company type (e.g., 'Investment Firm')
  - `organization_size` string — Organization size (e.g., '10-50')
  - `aum` integer — Assets Under Management
  - `country` string — Country code or name
  - `seats` integer — Number of licensed seats
  - `expiration_date` string, date-time, nullable — Expiration date in ISO 8601 format

## Response `200`

Successful Response

- OpenBBEntityCreateResponse — Schema for entity creation response.
  - `entity_uuid` string, required
  - `message` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)