Creating a token
- Log in to your reseller dashboard at
/dashboard - Go to Settings → API Tokens
- Click New token
- Give it a descriptive name (e.g.
WHMCS provisioning) - Select the required scopes
- Optionally add an IP allowlist (comma-separated CIDRs or IPs)
- Click Create and copy the token — it is shown only once
Token format
|, then a random string prefixed with pdns_ (the prefix makes leaked tokens detectable by GitHub/TruffleHog-style secret scanners). Pass the whole string — including the id| part — as the Bearer token.
Security recommendations
- Create one token per integration with minimum required scopes
- Store tokens in a secrets manager (Doppler, AWS Secrets Manager, HashiCorp Vault) — never in source code
- Enable an IP allowlist for production tokens to limit blast radius if a token is leaked
- Rotate tokens after any security incident