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

# Create Organization

> Create a new organization.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Body

<ParamField body="name" type="string" required>
  The name of the organization.
</ParamField>

### Response

<ResponseField name="data" type="object">
  The created organization details.
</ResponseField>

<ResponseField name="data.id" type="string">
  A unique identifier for the organization.
</ResponseField>

<ResponseField name="data.org_slug" type="string">
  A randomly generated unique slug for the organization.
</ResponseField>

<ResponseField name="data.org_display_name" type="string">
  The display name of the organization.
</ResponseField>

<ResponseField name="data.org_image_url" type="string | null">
  URL of the organization's image (if set).
</ResponseField>

<ResponseField name="data.org_plan" type="string">
  The organization's plan. Default: `"starter"`.
</ResponseField>

<ResponseField name="data.org_creation_date" type="string (ISO 8601)">
  The timestamp of when the organization was created.
</ResponseField>

<ResponseField name="data.kyc_level" type="integer">
  The KYC (Know Your Customer) verification level. Default: `0`.
</ResponseField>

<ResponseField name="data.placement_group" type="string">
  The placement group of the organization. Default: `"blandshared"`.
</ResponseField>

<ResponseField name="data.is_deleted" type="boolean">
  Whether the organization is deleted. Default: `false`.
</ResponseField>

<ResponseField name="data.is_stripe_overdue" type="boolean">
  Whether the organization has overdue Stripe payments. Default: `false`.
</ResponseField>

<ResponseField name="data.is_suspended" type="boolean">
  Whether the organization is suspended. Default: `false`.
</ResponseField>

<ResponseField name="data.org_rate_limit" type="integer">
  The organization's request rate limit. Default: `5`.
</ResponseField>

<ResponseField name="data.org_type" type="string">
  The type of the organization. Default: `"normal"`.
</ResponseField>

<ResponseField name="data.entitlements" type="array">
  A list of entitlements granted to the organization. Default: `[]`.
</ResponseField>

<ResponseField name="data.preferences.use_bland_url" type="boolean">
  Whether the organization prefers to use the Bland URL. Default: `true`.
</ResponseField>

<ResponseField name="errors" type="null | array">
  Contains error details if the request fails.
</ResponseField>

<ResponseExample>
  ```json Response   theme={null}
  {
      "data": {
          "id": "00705195-d5f2-4483-829e-07bb34df3625",
          "org_slug": "efbfd0c0-5017-4945-9156-16b56c11848e",
          "org_display_name": "Org Name",
          "org_image_url": null,
          "org_plan": "starter",
          "org_creation_date": "2025-02-14T06:06:01.504Z",
          "kyc_level": 0,
          "placement_group": "blandshared",
          "is_deleted": false,
          "is_stripe_overdue": false,
          "is_suspended": false,
          "org_rate_limit": 5,
          "org_type": "normal",
          "entitlements": [],
          "preferences": {
              "use_bland_url": true
          }
      },
      "errors": null
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)