> ## 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

## Create Organization

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

### Headers

<ParamField header="Authorization" type="string" required>
  API key is required. Enter your tenant-specific API key in the format 'Bearer
  YOUR-API-KEY'
</ParamField>

### Body Parameters

<ParamField body="name" type="string" required>
  The name of the organization
</ParamField>

<ParamField body="email" type="string" format="email" required>
  The email address for the organization
</ParamField>

<ParamField body="address" type="string" required>
  The street address of the organization
</ParamField>

<ParamField body="city" type="string" required>
  The city where the organization is located
</ParamField>

<ParamField body="stateProvince" type="string" required>
  The state or province where the organization is located
</ParamField>

<ParamField body="postalCode" type="string" required>
  The postal code or ZIP code for the organization
</ParamField>

<ParamField body="country" type="string" required>
  The country where the organization is located
</ParamField>

<ParamField body="phoneNumber" type="string" required>
  The contact phone number for the organization
</ParamField>

<ParamField body="timezone" type="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)
</ParamField>

<ParamField body="externalId" type="string">
  Optional external identifier for the organization
</ParamField>

### Response

<ResponseField name="id" type="string">
  The unique identifier for the newly created organization
</ResponseField>

<ResponseField name="name" type="string">
  The name of the organization
</ResponseField>

<ResponseField name="email" type="string">
  The email address for the organization
</ResponseField>

<ResponseField name="address" type="string">
  The street address of the organization
</ResponseField>

<ResponseField name="city" type="string">
  The city where the organization is located
</ResponseField>

<ResponseField name="stateProvince" type="string">
  The state or province where the organization is located
</ResponseField>

<ResponseField name="postalCode" type="string">
  The postal code or ZIP code for the organization
</ResponseField>

<ResponseField name="country" type="string">
  The country where the organization is located
</ResponseField>

<ResponseField name="phoneNumber" type="string">
  The contact phone number for the organization
</ResponseField>

<ResponseField name="tenantId" type="string">
  The tenant ID that the organization belongs to
</ResponseField>

<ResponseField name="timezone" type="string">
  The timezone for the organization
</ResponseField>

<ResponseField name="createdAt" type="string" format="date-time">
  The timestamp when the organization was created (ISO 8601 format:
  "2025-06-01T12:34:56Z")
</ResponseField>

<ResponseField name="createdBy" type="string">
  The ID of the user who created the organization
</ResponseField>

### Example Request

```bash theme={null}
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

```json theme={null}
{
  "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"
}
```