Webhook Events Reference

This page lists all available webhook events, grouped by category. Each event includes its trigger description and any event-specific payload fields beyond the common payload fields.

Certificate Applications

These events cover the full lifecycle of a certificate application — from creation through approval, rejection, or failure.

Event	Trigger
`certificate_application.created`	A new certificate application record is created (via customer submission, single vault upload, or bulk upload)
`certificate_application.processing`	An institution approves a customer-submitted application and processing begins
`certificate_application.approved`	A certificate application has been successfully processed and the certificate is approved
`certificate_application.rejected`	An institution administrator rejects a customer-submitted application
`certificate_application.failed`	Background processing (PDF generation, etc.) encountered a critical error
`certificate_application.retried`	An institution administrator re-initiates processing for a previously failed application

`certificate_application.created`

Triggered when a new certificate application record is created, regardless of source.

{
  "event": "certificate_application.created",
  "webhook_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "timestamp": "2026-06-04T10:30:00Z",
  "application_id": 42,
  "uuid": "9e7860f0-05d1-4fd0-b3e0-e98e19f1cf15",
  "certificate_title": "Certificate of Achievement",
  "applicant_email": "john@example.com",
  "source": "vault",
  "trigger_context": "bulk_upload"
}

Field	Type	Description
`source`	string	`vault` (institution-uploaded) or `customer` (user-submitted)
`trigger_context`	string	`single_upload`, `bulk_upload`, or `customer_submission`

`certificate_application.processing`

Triggered when an institution approves a customer-submitted application and processing begins.

{
  "event": "certificate_application.processing",
  "webhook_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "timestamp": "2026-06-04T10:30:00Z",
  "application_id": 42,
  "uuid": "9e7860f0-05d1-4fd0-b3e0-e98e19f1cf15",
  "certificate_title": "Certificate of Achievement",
  "applicant_email": "john@example.com",
  "source": "customer"
}

`certificate_application.approved`

Triggered when the certificate has been successfully processed and approved.

{
  "event": "certificate_application.approved",
  "webhook_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "timestamp": "2026-06-04T10:30:00Z",
  "application_id": 42,
  "uuid": "9e7860f0-05d1-4fd0-b3e0-e98e19f1cf15",
  "certificate_title": "Certificate of Achievement",
  "applicant_email": "john@example.com",
  "source": "vault"
}

`certificate_application.rejected`

Triggered when an institution administrator rejects a customer-submitted application.

{
  "event": "certificate_application.rejected",
  "webhook_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "timestamp": "2026-06-04T10:30:00Z",
  "application_id": 42,
  "uuid": "9e7860f0-05d1-4fd0-b3e0-e98e19f1cf15",
  "certificate_title": "Certificate of Achievement",
  "applicant_email": "john@example.com",
  "rejection_reason": "Duplicate certificate"
}

Field	Type	Description
`rejection_reason`	string	The reason provided by the administrator

`certificate_application.failed`

Triggered when background processing (PDF generation, QR code creation, etc.) encounters a critical error.

{
  "event": "certificate_application.failed",
  "webhook_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "timestamp": "2026-06-04T10:30:00Z",
  "application_id": 42,
  "uuid": "9e7860f0-05d1-4fd0-b3e0-e98e19f1cf15",
  "certificate_title": "Certificate of Achievement",
  "applicant_email": "john@example.com",
  "source": "vault",
  "error": "PDF generation failed: template not found"
}

Field	Type	Description
`error`	string	Description of the processing failure

`certificate_application.retried`

Triggered when an institution administrator re-initiates processing for a previously failed application.

{
  "event": "certificate_application.retried",
  "webhook_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "timestamp": "2026-06-04T10:30:00Z",
  "application_id": 42,
  "uuid": "9e7860f0-05d1-4fd0-b3e0-e98e19f1cf15",
  "certificate_title": "Certificate of Achievement",
  "applicant_email": "john@example.com",
  "source": "vault"
}