How to Add Domains

A DNS zone holds the records for a domain you control. You need an active DNS service and permission to manage the domain. Adding the zone does not register the name, update its registrar or automatically connect it to an Instance.

Use the domain's apex name, such as example.com, for the zone. Add a hostname such as www as a record within that zone when needed. Review the applicable DNS limits before adding more domains.

Add a Domain Using Automation

The published API defines these operations for an authorized account:

1. List DNS with GET /api/dns. The response contains DNS service IDs and zones; choose the service ID that belongs to the intended DNS service.
2. Add DNS Zone with POST /api/service/{service_id}/dns/. The required name field is the zone name, for example:

{"name": "example.com"}

Use the authentication described in the API reference. A POST creates a zone, so check the service and domain before submitting. Review the returned result, then list the service's zones to confirm that the intended zone exists. These are API contract instructions; a successful zone-creation request was not performed for this guide.

Add a Domain Using the Control Panel

Open DNS Management in the control panel. Select the active DNS service if one is listed. If the page returns to the dashboard or has no zone-management controls, confirm DNS service availability with support.

When your service provides a domain-creation form, enter the zone's apex name and the other fields it requires. Review the selected service and spelling before saving, then confirm that the zone appears in that service. If an existing-zone error appears, inspect the current zone or ask support about ownership before trying to create another one.

Next, manage the zone's records. For authoritative DNS hosting, complete the separate delegation checks before changing name servers at your registrar.