---
title: cert_will_expire
description: The v2 webhook payload for the cert_will_expire event. An uptime site's TLS certificate is about to expire.
url: https://docs.honeybadger.io/guides/integrations/payloads/v2/cert_will_expire/
---

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

## Fields

The table lists every field of the body. You can validate a delivery against this event’s [JSON Schema](https://docs.honeybadger.io/guides/integrations/payloads/v2/cert_will_expire.schema.json).

| 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

```json
{
  "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"
  }
}
```

---

## Try Honeybadger for FREE

Intelligent logging, error tracking, and Just Enough APM™ in one dev-friendly platform. Find and fix problems before users notice.

[Start free trial](https://app.honeybadger.io/users/sign_up)

[See plans and pricing](https://www.honeybadger.io/plans/)