Create Organization

curl --request POST \
  --url https://allomia.com/api/organization \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "email": "<string>",
  "address": "<string>",
  "city": "<string>",
  "stateProvince": "<string>",
  "postalCode": "<string>",
  "country": "<string>",
  "phoneNumber": "<string>",
  "timezone": "<string>",
  "externalId": "<string>"
}
'

import requests

url = "https://allomia.com/api/organization"

payload = {
    "name": "<string>",
    "email": "<string>",
    "address": "<string>",
    "city": "<string>",
    "stateProvince": "<string>",
    "postalCode": "<string>",
    "country": "<string>",
    "phoneNumber": "<string>",
    "timezone": "<string>",
    "externalId": "<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>',
    email: '<string>',
    address: '<string>',
    city: '<string>',
    stateProvince: '<string>',
    postalCode: '<string>',
    country: '<string>',
    phoneNumber: '<string>',
    timezone: '<string>',
    externalId: '<string>'
  })
};

fetch('https://allomia.com/api/organization', 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://allomia.com/api/organization",
  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>',
    'email' => '<string>',
    'address' => '<string>',
    'city' => '<string>',
    'stateProvince' => '<string>',
    'postalCode' => '<string>',
    'country' => '<string>',
    'phoneNumber' => '<string>',
    'timezone' => '<string>',
    'externalId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$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://allomia.com/api/organization"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"email\": \"<string>\",\n  \"address\": \"<string>\",\n  \"city\": \"<string>\",\n  \"stateProvince\": \"<string>\",\n  \"postalCode\": \"<string>\",\n  \"country\": \"<string>\",\n  \"phoneNumber\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"externalId\": \"<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://allomia.com/api/organization")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"email\": \"<string>\",\n  \"address\": \"<string>\",\n  \"city\": \"<string>\",\n  \"stateProvince\": \"<string>\",\n  \"postalCode\": \"<string>\",\n  \"country\": \"<string>\",\n  \"phoneNumber\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"externalId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://allomia.com/api/organization")

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  \"email\": \"<string>\",\n  \"address\": \"<string>\",\n  \"city\": \"<string>\",\n  \"stateProvince\": \"<string>\",\n  \"postalCode\": \"<string>\",\n  \"country\": \"<string>\",\n  \"phoneNumber\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"externalId\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "name": "<string>",
  "email": "<string>",
  "address": "<string>",
  "city": "<string>",
  "stateProvince": "<string>",
  "postalCode": "<string>",
  "country": "<string>",
  "phoneNumber": "<string>",
  "tenantId": "<string>",
  "timezone": "<string>",
  "createdAt": "<string>",
  "createdBy": "<string>"
}

POST

api

organization

Create Organization

curl --request POST \
  --url https://allomia.com/api/organization \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "email": "<string>",
  "address": "<string>",
  "city": "<string>",
  "stateProvince": "<string>",
  "postalCode": "<string>",
  "country": "<string>",
  "phoneNumber": "<string>",
  "timezone": "<string>",
  "externalId": "<string>"
}
'

import requests

url = "https://allomia.com/api/organization"

payload = {
    "name": "<string>",
    "email": "<string>",
    "address": "<string>",
    "city": "<string>",
    "stateProvince": "<string>",
    "postalCode": "<string>",
    "country": "<string>",
    "phoneNumber": "<string>",
    "timezone": "<string>",
    "externalId": "<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>',
    email: '<string>',
    address: '<string>',
    city: '<string>',
    stateProvince: '<string>',
    postalCode: '<string>',
    country: '<string>',
    phoneNumber: '<string>',
    timezone: '<string>',
    externalId: '<string>'
  })
};

fetch('https://allomia.com/api/organization', 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://allomia.com/api/organization",
  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>',
    'email' => '<string>',
    'address' => '<string>',
    'city' => '<string>',
    'stateProvince' => '<string>',
    'postalCode' => '<string>',
    'country' => '<string>',
    'phoneNumber' => '<string>',
    'timezone' => '<string>',
    'externalId' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>",
    "Content-Type: application/json"
  ],
]);

$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://allomia.com/api/organization"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"email\": \"<string>\",\n  \"address\": \"<string>\",\n  \"city\": \"<string>\",\n  \"stateProvince\": \"<string>\",\n  \"postalCode\": \"<string>\",\n  \"country\": \"<string>\",\n  \"phoneNumber\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"externalId\": \"<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://allomia.com/api/organization")
  .header("Authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"email\": \"<string>\",\n  \"address\": \"<string>\",\n  \"city\": \"<string>\",\n  \"stateProvince\": \"<string>\",\n  \"postalCode\": \"<string>\",\n  \"country\": \"<string>\",\n  \"phoneNumber\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"externalId\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://allomia.com/api/organization")

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  \"email\": \"<string>\",\n  \"address\": \"<string>\",\n  \"city\": \"<string>\",\n  \"stateProvince\": \"<string>\",\n  \"postalCode\": \"<string>\",\n  \"country\": \"<string>\",\n  \"phoneNumber\": \"<string>\",\n  \"timezone\": \"<string>\",\n  \"externalId\": \"<string>\"\n}"

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

{
  "id": "<string>",
  "name": "<string>",
  "email": "<string>",
  "address": "<string>",
  "city": "<string>",
  "stateProvince": "<string>",
  "postalCode": "<string>",
  "country": "<string>",
  "phoneNumber": "<string>",
  "tenantId": "<string>",
  "timezone": "<string>",
  "createdAt": "<string>",
  "createdBy": "<string>"
}

Create Organization

Creates a new organization within your tenant. This endpoint requires a valid tenant API key for authentication.

Headers

string

required

API key is required. Enter your tenant-specific API key in the format ‘Bearer YOUR-API-KEY’

Body Parameters

string

required

The name of the organization

string

required

The email address for the organization

string

required

The street address of the organization

string

required

The city where the organization is located

string

required

The state or province where the organization is located

string

required

The postal code or ZIP code for the organization

string

required

The country where the organization is located

string

required

The contact phone number for the organization

string

required

The timezone for the organization. Must be one of the supported timezone values: - America/New_York (Eastern Time) - America/Chicago (Central Time) - America/Denver (Mountain Time) - America/Los_Angeles (Pacific Time) - America/Anchorage (Alaska Time) - Pacific/Honolulu (Hawaii Time) - America/Phoenix (Mountain Time - Arizona) - America/Toronto (Eastern Time) - America/Vancouver (Pacific Time) - America/Edmonton (Mountain Time) - America/Winnipeg (Central Time) - America/Halifax (Atlantic Time) - America/St_Johns (Newfoundland Time) - Europe/London (British Time) - Europe/Paris (Central European Time) - Europe/Helsinki (Eastern European Time)

Asia/Dubai (Gulf Time) - Asia/Shanghai (China Time) - Asia/Tokyo (Japan Time) - Australia/Sydney (Australian Eastern Time) - Pacific/Auckland (New Zealand Time)

string

Optional external identifier for the organization

Response

string

The unique identifier for the newly created organization

string

The name of the organization

string

The email address for the organization

string

The street address of the organization

string

The city where the organization is located

string

The state or province where the organization is located

string

The postal code or ZIP code for the organization

string

The country where the organization is located

string

The contact phone number for the organization

string

The tenant ID that the organization belongs to

string

The timezone for the organization

string

The timestamp when the organization was created (ISO 8601 format: “2025-06-01T12:34:56Z”)

string

The ID of the user who created the organization

Example Request

curl -X POST https://allomia.com/api/organization \
  -H "Authorization: Bearer YOUR-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Valley Health Clinic",
    "email": "info@valleyhealthclinic.com",
    "address": "123 Main Street",
    "city": "San Francisco",
    "stateProvince": "CA",
    "postalCode": "94105",
    "country": "USA",
    "phoneNumber": "+14155551234",
    "timezone": "America/Los_Angeles",
    "externalId": "VHC001"
  }'

Example Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-123456789012",
  "name": "Valley Health Clinic",
  "email": "info@valleyhealthclinic.com",
  "address": "123 Main Street",
  "city": "San Francisco",
  "stateProvince": "CA",
  "postalCode": "94105",
  "country": "USA",
  "phoneNumber": "+14155551234",
  "tenantId": "tenant_123",
  "timezone": "America/Los_Angeles",
  "createdAt": "2025-06-01T12:34:56Z",
  "createdBy": "b2c3d4e5-f6a7-8901-bcde-234567890123"
}

List Organizations Get Organization

API Documentation

Organizations (Tenant Only)

Calls

Outbound Calls

Create Organization

Create Organization

Headers

Body Parameters

Response

Example Request

Example Response

​Create Organization

​Headers

​Body Parameters

​Response

​Example Request

​Example Response

Create Organization

Headers

Body Parameters

Response

Example Request

Example Response