Sign in

v1

latestOpenAPI 3.1.02026-07-1213613295.5 KB
Hetzner

Create Hetzner Server

Create a new server on Hetzner and register it in Coolify.

post/servers/hetzner

Request body

cloud_provider_token_uuidstring

Cloud provider token UUID. Required if cloud_provider_token_id is not provided.

cloud_provider_token_idstring

Deprecated: Use cloud_provider_token_uuid instead. Cloud provider token UUID.

locationstring required

Hetzner location name

server_typestring required

Hetzner server type name

imageinteger required

Hetzner image ID

namestring

Server name (auto-generated if not provided)

private_key_uuidstring required

Private key UUID

enable_ipv4boolean

Enable IPv4 (default: true)

enable_ipv6boolean

Enable IPv6 (default: true)

hetzner_ssh_key_idsinteger[]

Additional Hetzner SSH key IDs

cloud_init_scriptstring

Cloud-init YAML script (optional)

instant_validateboolean

Validate server immediately after creation

Example request

{
  "cloud_provider_token_uuid": "abc123",
  "cloud_provider_token_id": "abc123",
  "location": "nbg1",
  "server_type": "cx11",
  "image": 15512617,
  "name": "my-server",
  "private_key_uuid": "xyz789",
  "enable_ipv4": true,
  "enable_ipv6": true
}

Response

Hetzner server created.

uuidstring

The UUID of the server.

hetzner_server_idinteger

The Hetzner server ID.

ipstring

The server IP address.

Example response

{
  "uuid": "og888os"
}