Skip to main content

​
Method

POST /v1/organizations

​
Body Parameters

​
Headers

​
Authorization
string
Bearer token with organizations:write scope.
​
content-type
string
application/json

​
Request 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"}
  }'

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