cert_will_expire

An uptime site’s TLS certificate is about to expire.

Fields

25

The table lists every field of the body. You can validate a delivery against this event’s JSON Schema.

Field	Type	Description
event required	"cert_will_expire"
message required	string	A one-line summary of the event, as notifications show it.
actor	object	The person who caused the event. Absent when Honeybadger, or an API token with no user, did.
actor.id required	integer
actor.email required	string
actor.name required	string | null
project required	object	The project the event belongs to, by ID and name.
project.id required	integer
project.name required	string | null
site required	object	The uptime site the event is about.
site.id required	uuid
site.name required	string
site.url required	string	The checked URL, as entered.
site.frequency required	integer	Minutes between checks.
site.match_type required	string
site.match required	string | null
site.state required	string	Allowed values: pending, up, down.
site.active required	boolean
site.last_checked_at required	date-time | null
site.retries required	integer | null
site.proxy required	integer
site.cert_will_expire_at required	date-time | null
site.timeout required	integer | null
site.response_headers required	object | null	Headers the site is set to expect in each check's response.
site.details_url required	uri

Example

{
  "event": "cert_will_expire",
  "message": "[Billing API] SSL certificate for Checkout will expire on 11/4/2026 23:59:59 UTC",
  "project": {
    "id": 85736,
    "name": "Billing API"
  },
  "site": {
    "id": "8121ab91-87fd-4e92-ae23-a7b5bf915a2f",
    "name": "Checkout",
    "url": "https://billing.example.com/health",
    "frequency": 5,
    "match_type": "success",
    "match": null,
    "state": "up",
    "active": true,
    "last_checked_at": "2026-10-21T12:36:26.482113Z",
    "retries": 0,
    "proxy": 0,
    "cert_will_expire_at": "2026-11-04T23:59:59.000000Z",
    "timeout": null,
    "response_headers": null,
    "details_url": "https://app.honeybadger.io/projects/85736/sites/8121ab91-87fd-4e92-ae23-a7b5bf915a2f"
  }
}