SaaS custom hostname lifecycle
pending → ownership_validation → certificate_pending → active → renewing. Failed states keep instructions.
Answer first
pending → ownership_validation → certificate_pending → active → renewing. Failed states keep instructions.
How the platform treats it
Webhooks should fire on each transition.
Operational checklist
Confirm the hostname or product is in the correct organization. Prefer scoped credentials. Record the audit event. Subscribe to the matching webhook. Do not enable production ACME from a guide.
Failure modes
Expect DNS propagation delay, CA rate limits, and expired tokens. The API returns stable error codes rather than HTML error pages. Retry with backoff; do not loop validate calls from a browser tab.
Related inventory
After a successful change, inspect certificates, orders, deployments and billing documents. Unexpected Certificate Transparency entries are observations, not compromise claims.
Sources and limits
This guide describes software behavior. It is not legal, tax or CA-policy advice. Provider capabilities are cited from official documentation and fact-checked in admin content. Fact-check date: 2026-09-19.