Triggered when an SSL certificate is approaching expiration (typically 30 days before)
This webhook is sent when an SSL certificate is approaching expiration (typically 30 days before). The payload includes certificate details with expiry information and domains that will be affected.
Payload Example
{
"timestamp": 1640995200,
"event_type": "ssl_certificate.expire.soon",
"ssl_certificate": {
"stack_id": 123,
"name": "Awesome SSL Certificate",
"server_names": "example.com,awesome-example.com",
"lets_encrypt": true,
"has_intermediate_cert": true,
"ssl_termination": true,
"status": "installed",
"cert_expiry": "2024-02-01T00:00:00Z",
"days_until_expiry": 30,
"created_at": "2024-01-01T12:30:45Z",
"updated_at": "2024-01-01T12:35:30Z"
}
}Triggered when SSL certificate installation fails
This webhook is sent when SSL certificate installation fails. The payload structure is the same as ssl_certificate.install.ok but with status indicating failure and error details.
Payload Example
{
"timestamp": 1640995200,
"event_type": "ssl_certificate.install.fail",
"ssl_certificate": {
"stack_id": 123,
"name": "Awesome SSL Certificate",
"server_names": "example.com,awesome-example.com",
"lets_encrypt": true,
"has_intermediate_cert": false,
"ssl_termination": false,
"status": "failed",
"error_message": "Certificate validation failed",
"created_at": "2024-01-01T12:30:45Z",
"updated_at": "2024-01-01T12:35:30Z"
}
}Triggered when an SSL certificate is successfully installed
This webhook is sent when an SSL certificate is successfully installed. The payload includes certificate details (domains, expiry, type) and installation status and configuration.
Payload Example
{
"timestamp": 1640995200,
"event_type": "ssl_certificate.install.ok",
"ssl_certificate": {
"stack_id": 123,
"name": "Awesome SSL Certificate",
"server_names": "example.com,awesome-example.com",
"lets_encrypt": true,
"has_intermediate_cert": true,
"ssl_termination": true,
"status": "installed",
"cert_expiry": "2024-07-01T00:00:00Z",
"created_at": "2024-01-01T12:30:45Z",
"updated_at": "2024-01-01T12:35:30Z"
}
}