Create Organization

curl --request POST \
  --url https://api.bland.ai/v1/orgs/create \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "name": "<string>"
}
'

import requests

url = "https://api.bland.ai/v1/orgs/create"

payload = { "name": "<string>" }
headers = {
    "authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>'})
};

fetch('https://api.bland.ai/v1/orgs/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bland.ai/v1/orgs/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bland.ai/v1/orgs/create"

	payload := strings.NewReader("{\n  \"name\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/orgs/create")
  .header("authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/orgs/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
    "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
}

POST

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>"
}
'

import requests

url = "https://api.bland.ai/v1/orgs/create"

payload = { "name": "<string>" }
headers = {
    "authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: '<string>'})
};

fetch('https://api.bland.ai/v1/orgs/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bland.ai/v1/orgs/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bland.ai/v1/orgs/create"

	payload := strings.NewReader("{\n  \"name\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/orgs/create")
  .header("authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/orgs/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
    "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

string

required

Your API key for authentication.

Body

string

required

The name of the organization.

Response

object

The created organization details.

string

A unique identifier for the organization.

string

A randomly generated unique slug for the organization.

string

The display name of the organization.

string | null

URL of the organization’s image (if set).

string

The organization’s plan. Default: "starter".

string (ISO 8601)

The timestamp of when the organization was created.

integer

The KYC (Know Your Customer) verification level. Default: 0.

string

The placement group of the organization. Default: "blandshared".

boolean

Whether the organization is deleted. Default: false.

boolean

Whether the organization has overdue Stripe payments. Default: false.

boolean

Whether the organization is suspended. Default: false.

integer

The organization’s request rate limit. Default: 5.

string

The type of the organization. Default: "normal".

array

A list of entitlements granted to the organization. Default: [].

boolean

Whether the organization prefers to use the Bland URL. Default: true.

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
}

Docs for agents: llms.txt

⌘I

Basic Tutorials

Calls

Conversational Pathways

Knowledge Bases

Numbers

Blocked Numbers

Widgets

Tools

Contacts

Memory

Node tests

Agent Testing

Evals

Guard Rails

Web Agents

Live Translation

Custom Twilio Accounts

Batches

Prompts

Account

Organizations

Messaging

SIP Trunks

Custom Dialing Pools

Personas

Citation Schemas

Alarms

Triage

Create Organization

Headers

Body

Response

​Headers

​Body

​Response

Headers

Body

Response