Skip to main content
POST
https://api.bland.ai
/
v1
/
orgs
/
create
Create Organization
curl --request POST \
  --url https://api.bland.ai/v1/orgs/create \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "name": "<string>"
}
'
{
    "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
}

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body

​
name
string
required
The name of the organization.

​
Response

​
data
object
The created organization details.
​
data.id
string
A unique identifier for the organization.
​
data.org_slug
string
A randomly generated unique slug for the organization.
​
data.org_display_name
string
The display name of the organization.
​
data.org_image_url
string | null
URL of the organization’s image (if set).
​
data.org_plan
string
The organization’s plan. Default: "starter".
​
data.org_creation_date
string (ISO 8601)
The timestamp of when the organization was created.
​
data.kyc_level
integer
The KYC (Know Your Customer) verification level. Default: 0.
​
data.placement_group
string
The placement group of the organization. Default: "blandshared".
​
data.is_deleted
boolean
Whether the organization is deleted. Default: false.
​
data.is_stripe_overdue
boolean
Whether the organization has overdue Stripe payments. Default: false.
​
data.is_suspended
boolean
Whether the organization is suspended. Default: false.
​
data.org_rate_limit
integer
The organization’s request rate limit. Default: 5.
​
data.org_type
string
The type of the organization. Default: "normal".
​
data.entitlements
array
A list of entitlements granted to the organization. Default: [].
​
data.preferences.use_bland_url
boolean
Whether the organization prefers to use the Bland URL. Default: true.
​
errors
null | array
Contains error details if the request fails.
{
    "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
}