Create custom hostnames

1. In the Cloudflare dashboard, go to the Custom Hostnames page.

   Go to Custom Hostnames ↗

2. Select Add Custom Hostname.

3. Add your customer's hostname app.customer.com and set the relevant options, including:

   • Select the minimum TLS version.
   • Select the validation method.
   • Define a custom origin server.
   • Enterprise customers can also select the certificate authority (CA), upload a custom certificate, or enable wildcard, which adds a *.<custom-hostname> SAN to the custom hostname certificate. For more details, refer to Hostname priority and Plans.

4. Select Add Custom Hostname.

1. To create a custom hostname using the API, use the Create Custom Hostname endpoint.

   • Only Enterprise customers can use the certificate_authority parameter to specify a CA, the custom_certificate/custom_cert_bundle to upload a custom certificate, or wildcard to create a wildcard certificate. Refer to Plans.
   • You can leave the certificate_authority parameter empty to set it to "default CA". With this option, Cloudflare checks the CAA records before requesting the certificates, which helps ensure the certificates can be issued from the CA.

2. For the newly created custom hostname, the POST response may not return the DCV validation token validation_records. It is recommended to make a second GET command (with a delay) to retrieve these details.

The response contains the complete definition of the new custom hostname.