Link custom domain
API Reference
Link custom domain
This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.
Attaches the domain to Base44’s hosting and starts DNS verification.
Call this after adding a domain, and again after Unlink custom domain to put it back into service. Linking re-enables any email domain configured on it.
The response body is
null. Read the domain back with Get custom domain to see the result.Verification does not finish here. Linking asks the provider to start checking DNS; poll Get custom domain status until verificationStatus is verified.
A domain is only serving traffic once it is linked and its
last_status_payload.verificationStatus is verified. Adding a domain and linking it are separate steps, and DNS propagation happens outside Base44, so a linked domain can sit unverified for as long as its nameservers take.POST
Link custom domain
Authorizations
Personal API key.
Path Parameters
ID of the app the domain belongs to.
ID of the custom domain, as returned in id by List custom domains.
Response
The domain is attached and verification has started. The body is null.