certificate.renewed
Fires when a user requalifies and their certificate is renewed with a new expiration date.
01
Payload fields
Fields below arrive inside the
payload key of the standard
request envelope.
| Field | Type | Description |
|---|---|---|
id |
integer | The certificate's unique ID in Preserve. |
certificate_number |
string | Unique certificate number, e.g. CERT-3F9A8C1B2D4E. |
title |
string | Certificate title. |
status |
string | Certificate status: active, expired, or revoked. |
user_id |
integer | ID of the certified user. |
user |
string | Display name of the certified user. |
user_email |
string | Email of the certified user. |
issue_date |
string (date) | null | Date the certificate was issued. |
expires_at |
string (date) | null | Expiration date. Null when the certificate does not expire. |
organization_id |
integer | Owning org ID. |
organization |
string | Owning org display name. |
url |
string | Link to the certificate in Preserve. Requires a signed-in admin with access. |
02
Example deliveries
certificate.renewed
{ "hook": { "name": "My Integration" }, "event": "certificate.renewed", "payload": { "id": 91, "certificate_number": "CERT-3F9A8C1B2D4E", "title": "Confined Space Entry", "status": "active", "user_id": 17, "user": "Dana Rivera", "user_email": "dana.rivera@acme.example.com", "issue_date": "2026-06-01", "expires_at": "2028-06-01", "organization_id": 7, "organization": "Acme Energy", "url": "https://app.example.com/learn/admin/certificates/91" }}