Method
POST /v1/organizations
Body Parameters
Headers
string
Bearer token with
organizations:write scope.string
application/jsonRequest Example
curl -X POST https://api.voyantcloud.com/v1/organizations \
-H "Authorization: Bearer $VOYANT_API_KEY" \
-H "content-type: application/json" \
-d '{
"name": "Voyant Cruises",
"legal_name": "Voyant Cruises SRL",
"email": "contact@voyantcruises.com",
"phone": "+40 700 000 001",
"description": "Cruise specialist partner",
"tax_id": "RO12345678",
"kind": "agency",
"metadata": {"tier": "gold"}
}'
await fetch("https://api.voyantcloud.com/v1/organizations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VOYANT_API_KEY}`,
"content-type": "application/json",
},
body: JSON.stringify({ name: "Voyant Cruises", kind: "agency" }),
})
import os, requests
payload = {
"name": "Voyant Cruises",
"email": "contact@voyantcruises.com",
"kind": "agency"
}
resp = requests.post(
"https://api.voyantcloud.com/v1/organizations",
headers={
"Authorization": f"Bearer {os.environ['VOYANT_API_KEY']}",
"content-type": "application/json",
},
json=payload,
)
organization = resp.json()
Response
{
"data": {
"id": "org_123",
"name": "Voyant Cruises",
"legalName": "Voyant Cruises SRL",
"email": "contact@voyantcruises.com",
"phone": "+40 700 000 001",
"description": "Cruise specialist partner",
"taxId": "RO12345678",
"kind": "agency",
"billingAddress": null,
"visitingAddress": null,
"metadata": { "tier": "gold" },
"createdAt": "2025-02-20T10:00:00.000Z",
"updatedAt": "2025-02-20T10:00:00.000Z"
}
}
{ "error": "Validation failed", "details": [ ... ] }
Only
name is required; all other fields are optional and can be supplied when available. Both camelCase and snake_case keys are accepted for backwards compatibility.