Skip to main content
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>"
}
'
{
  "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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.allomia.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Create Organization

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

​
Headers

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

​
Body Parameters

​
name
string
required
The name of the organization
​
email
string
required
The email address for the organization
​
address
string
required
The street address of the organization
​
city
string
required
The city where the organization is located
​
stateProvince
string
required
The state or province where the organization is located
​
postalCode
string
required
The postal code or ZIP code for the organization
​
country
string
required
The country where the organization is located
​
phoneNumber
string
required
The contact phone number for the organization
​
timezone
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)
​
externalId
string
Optional external identifier for the organization

​
Response

​
id
string
The unique identifier for the newly created organization
​
name
string
The name of the organization
​
email
string
The email address for the organization
​
address
string
The street address of the organization
​
city
string
The city where the organization is located
​
stateProvince
string
The state or province where the organization is located
​
postalCode
string
The postal code or ZIP code for the organization
​
country
string
The country where the organization is located
​
phoneNumber
string
The contact phone number for the organization
​
tenantId
string
The tenant ID that the organization belongs to
​
timezone
string
The timezone for the organization
​
createdAt
string
The timestamp when the organization was created (ISO 8601 format: “2025-06-01T12:34:56Z”)
​
createdBy
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"
}