API ReferenceClusters
Create Cluster
Create a new VPS cluster with a new domain
Create Cluster
Provisions a new Contabo VPS cluster with a new domain. This includes:
- Purchasing a domain
- Provisioning a VPS server
- Setting up DNS records
- Installing mail server (Postfix/Dovecot)
⚠️ Warning: This endpoint charges your wallet. Domain: $16.00, Server: $25.00 (if not using existing VPS). Ensure sufficient balance.
Request
-
domain(string) (required) — The domain to purchase and configure (e.g.,mycompany.com) -
useExistingVps(boolean) (default:false) — Iftrue, creates the cluster on an existing VPS instead of provisioning a new one. Saves $25.00.
curl -X POST https://api.hermes.camie.ai/v1/clusters/create \
-H "Authorization: Bearer hermes_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"domain": "outreach-company.com",
"useExistingVps": false
}'const res = await fetch('https://api.hermes.camie.ai/v1/clusters/create', {
method: 'POST',
headers: {
'Authorization': 'Bearer hermes_your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
domain: 'outreach-company.com',
useExistingVps: false
})
});
const data = await res.json();Response (201 Created)
{
"success": true,
"data": {
"id": 203,
"domain": "outreach-company.com",
"status": "provisioning",
"ipAddress": null,
"jobId": "cluster-deploy-203",
"createdAt": "2026-03-14T15:00:00.000Z"
}
}Wallet Charge Breakdown
| Component | Cost | Condition |
|---|---|---|
| Domain purchase | $16.00 | Always (new domain) |
| VPS server | $25.00 | When useExistingVps: false |
| Total | $41.00 | New domain + new server |
Error: Insufficient Balance (402)
{
"success": false,
"error": "Insufficient wallet balance. Required: $41.00, Available: $20.00"
}📝 Note: Cluster provisioning is asynchronous. Use the
jobIdto check progress via Get Cluster.