Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from IONOS_TOKEN is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration.

​
Setup

  1. Get an IONOS Cloud account: Sign up at https://cloud.ionos.com - new accounts typically include trial credit. Log into the Data Center Designer (DCD) at https://dcd.ionos.com.
  2. Generate a bearer token: In the DCD open Management > Token Manager and generate a token, or call GET https://api.ionos.com/auth/v1/tokens/generate with Basic auth (Base64 of username:password). Tokens are required if 2FA is enabled.
  3. Set the environment variable: Copy the token into your .env as IONOS_TOKEN.
  4. Verify access: Run List Data Centers (depth=1), then List Servers for one of the returned data center IDs.

​
Provider notes

  • All Cloud API v6 paths live under https://api.ionos.com/cloudapi/v6
  • The depth query parameter (0-10) controls how deeply nested resources are expanded; depth=0 returns only IDs
  • Stopping a server is a forceful power-off; shut down the OS first for clean stops
  • Write requests return 202 Accepted and complete asynchronously - check the server’s vmState afterwards
Provider API reference.

​
Tools

​
Verify the connection

Call a read tool such as ionos__list_datacenters with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.