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

# Provision Entity With Users

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

Provision a complete OpenBB entity with admins and users.

This is a convenience endpoint that:
1. Creates the entity
2. Sets up default entitlements
3. Creates admin users
4. Creates regular users

All users receive temporary passwords that should be changed on first login.

## Request body

- OpenBBProvisionRequest — Schema for bulk provisioning an entity with users.
  - `entity` OpenBBEntityCreate, required — 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
  - `admins` OpenBBProvisionUserInfo[] — List of admin users to create
    - `email` string, email, required
    - `first_name` string, required
    - `last_name` string, required
  - `users` OpenBBProvisionUserInfo[] — List of regular users to create
    - `email` string, email, required
    - `first_name` string, required
    - `last_name` string, required

## Response `200`

Successful Response

- OpenBBProvisionResponse — Schema for provisioning response.
  - `entity` object, required
  - `admins` OpenBBProvisionedUser[], required
    - `email` string, required
    - `user_uuid` string, nullable
    - `temporary_password` string, nullable
  - `users` OpenBBProvisionedUser[], required
    - `email` string, required
    - `user_uuid` string, nullable
    - `temporary_password` string, nullable
  - `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)