Actions111
- Action Actions
- Certificate Actions
- Datacenter Actions
- Firewall Actions
- Floating IP Actions
- Image Actions
- ISO Actions
- Load Balancer Actions
- Load Balancer Type Actions
- Location Actions
- Network Actions
- Placement Group Actions
- Pricing Actions
- Primary IP Actions
- Server Actions
- Server Type Actions
- SSH Key Actions
- Volume Actions
Floating IP → Create
AI-generatedSummary
Creates a new Hetzner Cloud Floating IP by sending POST /v1/floating_ips with the chosen IP type and either a home location or a server to assign it to.
Inputs
- Type (required) — IP version of the Floating IP: IPv4 (default) or IPv6. Sent as
type. - Home Location — Location name such as fsn1, sent as
home_location. The field description says it is required unless a server is given. - Server — Server to assign the new Floating IP to. Pick from a searchable list or enter the ID. It is sent as a numeric
serverfield. - Additional Body Fields (JSON) — JSON object for any other API fields, such as name, description or labels. It is shared with the Update operation and defaults to {}. In this operation's routing, no preSend step merges it into the request body, so its effect is unconfirmed.
- Request Options — Node settings for batching (items per batch, interval), ignoring SSL issues, proxy and timeout (default 10000 ms).
Output shape
One item per input item, containing the raw Hetzner API response for the create call.
The operation has no response unwrapping, so the output is not reduced to the floating_ip object. It should keep the API's top-level wrapper, which normally holds
floating_ipplus anactionwhen a server is assigned. Authentication uses the hetznerCloudApi credential.
Examples
Example 1: Reserve an IPv4 Floating IP in Falkenstein
Type = IPv4, Home Location = fsn1, leave Server empty.
Example 2: Create an IPv6 Floating IP and assign it to an existing server
Type = IPv6, Server = chosen from list or by ID. Home Location can be left empty.
Example 3: Create a named, labelled Floating IP
Type = IPv4, Home Location = nbg1, Additional Body Fields = {"name":"web-ip","labels":{"env":"prod"}}. The merge of this JSON into the request is unconfirmed, so check the output.