Alerting

Certificate alerting keeps your team informed about critical lifecycle events. Alerts are configured per Application and apply to all certificates within that Application.

Alert Types

<CardGroup cols={2}> <Card title="Expiration" icon="clock"> Notifies when certificates approach expiration. Configure how far in advance (e.g., 30 days). </Card> <Card title="Issuance" icon="certificate"> Notifies immediately when a new certificate is issued. </Card> <Card title="Renewal" icon="arrows-spin"> Notifies immediately when a certificate is renewed. </Card> <Card title="Revocation" icon="ban"> Notifies immediately when a certificate is revoked. </Card> </CardGroup>

Create an Alert

In your Application, go to the Settings tab and find the Alerting section. Click Create Alert.

Field	Description
Name	A slug-friendly name like expiry-alert
Alert Type	Expiration, Issuance, Renewal, or Revocation
Description	Optional context about this alert

For expiration alerts, you'll also configure:

Field	Description
Alert Before	How far before expiration to notify (e.g., 30d, 2w, 1m)
Daily Alerts	If enabled, sends daily reminders until the certificate expires or is renewed

Notification Channels

Add one or more channels to receive alerts (up to 10 per alert):

Channel	Description
Email	Send to a list of email addresses
Slack	Post to a Slack channel via Incoming Webhook
PagerDuty	Create incidents via Events API v2
Webhook	POST to any HTTPS endpoint with optional signature verification

FAQ

<AccordionGroup> <Accordion title="Do alerts apply to all certificates in the Application?"> Yes. When you create an alert on an Application, it monitors all certificates issued within that Application. The Application itself is the scope. </Accordion> <Accordion title="When do expiration alerts run?"> Expiration alerts are checked on a daily schedule. Event-driven alerts (Issuance, Renewal, Revocation) fire in real-time. </Accordion> <Accordion title="Can I have multiple alerts on one Application?"> Yes. You can create multiple alerts with different types and notification channels. For example, an expiration alert to Slack and an issuance alert to a webhook for audit logging. </Accordion> </AccordionGroup>

What's Next?

<CardGroup cols={2}> <Card title="Slack Alerts" icon="slack" href="/documentation/platform/pki/applications/alerting/slack"> Set up Slack Incoming Webhook integration. </Card> <Card title="PagerDuty Alerts" icon="pager" href="/documentation/platform/pki/applications/alerting/pagerduty"> Configure PagerDuty Events API integration. </Card> <Card title="Webhook Alerts" icon="webhook" href="/documentation/platform/pki/applications/alerting/webhook"> Send alerts to custom endpoints. </Card> <Card title="Certificates" icon="certificate" href="/documentation/platform/pki/applications/certificates"> View and manage your certificate inventory. </Card> </CardGroup>