Skip to main content

Digests and endpoint health alerts

Use a weekly digest for a consolidated expiry summary, or enable endpoint health checks for outage and recovery notifications. Both use workspace delivery windows and channels. Individual expiry reminders are covered in Expiry reminders and thresholds.

Weekly digest​

Pro and up

Weekly digests summarize upcoming expiry.

  • Enable: choose Email, WhatsApp or Webhook weekly digest per contact group on Pro or Team. Email and WhatsApp require current recipient consent.
  • Schedule: Monday runs respect delivery windows; runs outside the window are skipped. The following Monday starts a new week.
  • Selection: include unexpired assets within the largest positive workspace threshold. Shared recipients receive one digest across groups.
  • Delivery: accepted sends are finalized without resending. Uncertain provider outcomes stay held; contact support if delivery remains unconfirmed.
  • Payload: PagerDuty is excluded. Generic webhook payloads retain contact_group and include the contact_groups array.

Endpoint health alerts​

When you add an endpoint monitor with health checking enabled, TokenTimer tracks the health status of that URL and alerts you when it goes down or recovers. Alerts are triggered on state transitions only, not on every check.

How it works​

  • First check: the very first health check establishes a baseline. No alert is sent regardless of the result.
  • Healthy to unhealthy: when an endpoint transitions from healthy to unhealthy (HTTP error, timeout), a "down" alert is queued.
  • Unhealthy to healthy: when an endpoint recovers, a "recovered" alert is sent, but only if you were previously notified it was down.
  • No change: if the status stays the same between checks, no new alert is created.

Alert after failures​

To avoid false alarms from brief network glitches, you can configure how many consecutive failures must occur before you are notified. This is the "Alert after failures" setting on each endpoint.

  • Default is 2 consecutive failures.
  • The "down" alert is queued immediately on the first failure transition, but the delivery worker waits until the failure count reaches the threshold before sending the notification.
  • If the endpoint recovers before the threshold is reached, the queued alert is silently discarded and you receive nothing.
  • Recovery alerts have no consecutive-failure gate, but still respect the delivery window. They are sent only if a "down" notification was previously delivered.

One notification per state change​

  • Only one "down" alert is sent per outage, no matter how long the endpoint stays unhealthy.
  • Only one "recovered" alert is sent when the endpoint comes back online.
  • If an endpoint was never healthy (for example a misconfigured URL), the first check produces no baseline transition. A "down" alert fires only after it eventually becomes healthy and then goes unhealthy again.
  • Recovery alerts are never sent if you were not previously informed of the outage.

Delivery channels and contact groups​

Endpoint health alerts use the same delivery channels configured in your workspace alert settings and respect your delivery window.

  • When adding an endpoint, you can select contact groups to receive alerts. This is set on the auto-created SSL token.
  • If none are selected, the workspace default contact group is used automatically.
  • You can change the assigned groups later by editing the SSL token directly.