Certify+

Webhooks (preview)

Coming soon. Webhooks are not yet available. This page documents the planned event catalog so integrations can plan ahead.

Planned events

| Event | Fired when | |---|---| | certificate.issued | A certificate is created via the API or dashboard. | | certificate.revoked | A certificate is revoked. | | verification.occurred | /verify/:code is called against one of your certificates. |

Planned delivery model

  • One POST per event to each registered endpoint.
  • X-Certify-Signature header carrying an HMAC-SHA256 of the payload against your endpoint secret.
  • At-least-once delivery with exponential backoff (1m → 5m → 15m → 1h → 6h, then stop).
  • Per-endpoint retry log visible in Settings → Webhooks.

Planned payload shape

{
  "id": "evt_01H…",
  "type": "certificate.issued",
  "createdAt": "2026-04-19T09:10:11.123Z",
  "data": {
    "certificate": {
      "id": "8f4d…",
      "uniqueCode": "ABC12345",
      "recipientName": "Jane Doe",
      "templateId": "…",
      "status": "Issued"
    }
  }
}

Until webhooks land

Poll GET /api/v1/certificates?status=Issued&page=1&perPage=100 and filter by createdAt. This works for low-volume workflows; high-volume integrations should wait for real webhooks.

Follow the changelog for the launch announcement.