Exactly like when requesting through the UI, the issuance of a new Let's Encrypt certificate requested via API happens asynchronously. Once the certificate is issued, we'll notify you via email and webhooks. At that point, you can use our certificate download API to download the certificate and the private key.

When you create a Let's Encrypt certificate you can pass the option to auto-renew the certificate. When auto-renewal is enabled, we'll automatically process the auto-renewal 30 days before the expiration. Once a renewed certificate is issued, we'll notify you via email and webhooks as for the original certificate.

The feature is currently in beta. It is stable and can be used, however during the beta period we may make adjustments to the API format. The best way to stay up to date is to use one of our official API clients: