Update Organization

curl --request PUT \
  --url https://allomia.com/api/organization/{id} \
  --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>"
}
'

import requests

url = "https://allomia.com/api/organization/{id}"

payload = {
    "name": "<string>",
    "email": "<string>",
    "address": "<string>",
    "city": "<string>",
    "stateProvince": "<string>",
    "postalCode": "<string>",
    "country": "<string>",
    "phoneNumber": "<string>",
    "timezone": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  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>'
  })
};

fetch('https://allomia.com/api/organization/{id}', 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/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'email' => '<string>',
    'address' => '<string>',
    'city' => '<string>',
    'stateProvince' => '<string>',
    'postalCode' => '<string>',
    'country' => '<string>',
    'phoneNumber' => '<string>',
    'timezone' => '<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/{id}"

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

	req, _ := http.NewRequest("PUT", 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.put("https://allomia.com/api/organization/{id}")
  .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}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Put.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}"

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

PUT

api

organization

{id}

Update Organization

curl --request PUT \
  --url https://allomia.com/api/organization/{id} \
  --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>"
}
'

import requests

url = "https://allomia.com/api/organization/{id}"

payload = {
    "name": "<string>",
    "email": "<string>",
    "address": "<string>",
    "city": "<string>",
    "stateProvince": "<string>",
    "postalCode": "<string>",
    "country": "<string>",
    "phoneNumber": "<string>",
    "timezone": "<string>"
}
headers = {
    "Authorization": "<authorization>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  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>'
  })
};

fetch('https://allomia.com/api/organization/{id}', 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/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'email' => '<string>',
    'address' => '<string>',
    'city' => '<string>',
    'stateProvince' => '<string>',
    'postalCode' => '<string>',
    'country' => '<string>',
    'phoneNumber' => '<string>',
    'timezone' => '<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/{id}"

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

	req, _ := http.NewRequest("PUT", 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.put("https://allomia.com/api/organization/{id}")
  .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}")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Put.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}"

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

Update Organization

Updates an existing organization. This endpoint requires a valid tenant API key for authentication. While this is an update operation, the name and email fields are required and must be provided in the request body.

Headers

string

required

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

Path Parameters

string

required

The unique identifier of the organization to update

Body Parameters

string

required

The updated name of the organization

string

required

The updated email address for the organization

string

The updated street address of the organization

string

The updated city where the organization is located

string

The updated state or province where the organization is located

string

The updated postal code or ZIP code for the organization

string

The updated country where the organization is located

string

The updated contact phone number for the organization

string

The updated 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)

Response

string

The unique identifier for the organization

string

The updated name of the organization

string

The updated email address for the organization

string

The updated street address of the organization

string

The updated city where the organization is located

string

The updated state or province where the organization is located

string

The updated postal code or ZIP code for the organization

string

The updated country where the organization is located

string

The updated contact phone number for the organization

string

The tenant ID that the organization belongs to

string

The updated 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 PUT https://allomia.com/api/organization/a1b2c3d4-e5f6-7890-abcd-123456789012 \
  -H "Authorization: Bearer YOUR-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Valley Health Clinic - Downtown",
    "email": "downtown@valleyhealthclinic.com",
    "address": "456 Downtown Boulevard",
    "city": "San Francisco",
    "stateProvince": "CA",
    "postalCode": "94102",
    "country": "USA",
    "phoneNumber": "+14155557890",
    "timezone": "America/Los_Angeles"
  }'

Example Response

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

Error Responses

400: Invalid request data

{
  "error": "Missing required fields: name and email are required"
}

401: Unauthorized

{
  "error": "Invalid or missing API key"
}

404: Organization not found

{
  "error": "Organization not found for the provided ID"
}

500: Error

{
  "error": "Internal server error occurred"
}

API Documentation

Organizations (Tenant Only)

Calls

Outbound Calls

Update Organization

Update Organization

Headers

Path Parameters

Body Parameters

Response

Example Request

Example Response

Error Responses

​Update Organization

​Headers

​Path Parameters

​Body Parameters

​Response

​Example Request

​Example Response

​Error Responses

Update Organization

Headers

Path Parameters

Body Parameters

Response

Example Request

Example Response

Error Responses