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>"
}Organizations (Tenant Only)
Create Organization
Creates a new organization
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"
}