Skip to content
netcupgutscheine.com
← All guides
API & automationUpdated: 02/11/2026

Netcup API: automate DNS and servers

The Netcup API is split: CCP for DNS/domains and SCP for servers. This guide shows which API to use and how to start safely.

1. CCP API vs SCP REST API

The CCP API (legacy JSON/SOAP) manages DNS zones, domains and reseller functions. The SCP REST API controls servers: start/stop, snapshots, ISO, network and more. Use CCP for DNS, SCP for server automation.

  • DNS/CloudDNS: CCP API (legacy JSON or the new netcup API).
  • Servers: SCP REST API.
  • Both APIs use separate keys and permissions.

2. API key and session

Create the key in the CCP under "Master Data → API". The session is created by login and expires after 15 minutes of inactivity. Never commit keys or passwords.

curl -sS -X POST "https://ccp.netcup.net/run/webservice/servers/endpoint.php?JSON" \
  -H "Content-Type: application/json" \
  -d '{"action":"login","param":{"customernumber":"123456","apikey":"KEY","apipassword":"PASSWORD"}}'

Note: The response contains a session ID. Use placeholders and keep real keys in a secret store.

3. Read DNS records

Use infoDnsRecords to read the records of a zone. The exact payload fields and error codes are in the official legacy API docs; the method is stable, but check the docs before every script.

curl -sS -X POST "https://ccp.netcup.net/run/webservice/servers/endpoint.php?JSON" \
  -H "Content-Type: application/json" \
  -d '{"action":"infoDnsRecords","param":{"domainname":"example.com","customernumber":"123456","apikey":"KEY","apisessionid":"SESSION"}}'

Note: DNS changes can break your domain or mail immediately. Test on a subdomain with a short TTL first.

4. Terraform, CLI and guardrails

There is no official Netcup Terraform provider. Use the official API, the community clients linked in the Netcup docs, or our netcup-toolbox CLI. For production: rotate keys, plan changes, export DNS zones.

  • API keys with minimal permissions and a description.
  • Dry-run/plan changes before applying them.
  • Export DNS zones before bulk changes.
  • Check logs and API responses for error codes.

Official sources

netcup APICurrent API documentation.Legacy APICCP JSON/SOAP, DNS and domains.SCP REST APIServer automation.netcup-toolboxCLI examples and DNS client.

Matching plans

VPS 1000 G12.5

Bestseller
VPS • G12.5
1 Month Free
€14.50/ moincl. 19% VAT12-month term

4 vCores (x86) · 8 GB RAM · 128 GB SSD · 2.5 Gbit/s

GB6: 1,720/4,650 · Steal: 1.2 %

Loading current code…

RS 1000 G12.5

Bestseller
Root server • G12.5
2 Months Free
€21.73/ moincl. 19% VAT12-month term

4 Dedicated Cores (AMD EPYC 9645) · 8 GB RAM · 128 GB NVMe · 2.5 Gbit/s

GB6: 2,290/7,559 · Steal: 0.0 %

Loading current code…

Frequently asked questions

Which API for CloudDNS?

CloudDNS uses the new netcup API; the legacy CCP API remains for classic DNS zones. Check the official docs to see which method fits your domain type.

Source
How long is the API session valid?

The legacy CCP session expires after 15 minutes of inactivity. Logout ends it immediately; scripts should not store it permanently.

Source
Can I reboot servers via the CCP API?

No, server actions run through the SCP REST API. The CCP API is for DNS, domains and reseller functions.

Source