Add a custom hostname

A property can serve traffic on one or more hostnames. You add your own domain (for example www.mycompany.com) from the property's Hostnames tab. What happens next depends on whether the hostname is a Paradarum system domain or an external domain.

Add a hostname

1. Open the property in your dashboard and go to the Hostnames tab.
2. Click Add. A new editable row appears with a name input (placeholder cdn.domain.com).
3. Type your hostname, for example www.mycompany.com. The field validates hostname format as you type and shows Invalid hostname format! if it is malformed.
4. Click the check (save) icon to submit, or the X icon to cancel.

Behind the scenes this calls the Add hostname endpoint:

curl -X POST 'https://api.paradarum.com/api/Property/123/hostname?accountId=45' \
  -H 'X-API-Key: pdm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "name": "www.mycompany.com" }'

Only name is consumed from the request body. Server-controlled fields (status, certificate type, system-default flag) are set by the API and cannot be supplied by the client.

System hostnames vs external domains

The result of adding a hostname depends on its domain.

Hostname type	Examples	What happens
Paradarum system domain	*.prdrm.net, *.paradarum.com	Activated instantly; SSL is requested automatically. DNS is auto-managed by Paradarum.
External / custom domain	www.mycompany.com	API checks whether DNS already resolves to a PoP IP. If yes, it activates and requests a certificate. If not, it is created as PendingValidation with no certificate yet.

info

When you add an external domain whose DNS is not yet pointing at the CDN, the API still returns HTTP 201 (success) — but with a warning, and the hostname stays in PendingValidation. No certificate is requested until DNS is verified.

A typical warning response looks like this:

Hostname created successfully. WARNING: DNS verification failed. SSL certificate
will NOT be requested automatically. Please configure your DNS to point to one of
these IPs: <ip1>, <ip2>. After DNS is configured, use the 'Request Certificate'
action to retry.

When you see this, follow Configure a CNAME to point your DNS at the property's system hostname, then verify DNS and retry SSL.

You cannot add a hostname under platform domains

prdrm.net and paradarum.com are protected platform domains. You cannot add a hostname under them yourself — every property already gets its own system hostname automatically. Attempting to add one returns:

400  Protected system domains cannot be added

Other rejections to be aware of:

• Duplicate hostname — adding a hostname that already exists returns 400.
• Wrong property/account — a missing property or mismatched accountId returns 404.

Hostname statuses

The status column reflects the HostnameStatus enum. The values are integers in the API and UI.

Status	Value	UI badge	Meaning
PendingValidation	0	Yellow	Created, but DNS does not yet resolve to a PoP. No certificate.
Active	1	Green	Serving traffic; certificate issued or in progress.
Error	2	Red	Verification or certificate issuance failed.
Disabled	3	Gray	Not serving traffic.

note

System default hostnames cannot be deleted and have no upload or delete controls. The trash icon (with confirmation) removes any custom hostname you added.

Next steps

• Configure a CNAME to point your external domain at the CDN.
• Verify DNS and retry SSL to move a PendingValidation hostname to Active.