Webhooks

Send a sample event

Enqueues a synthetic event delivery for the requested event type so consumers can verify their endpoint and pull a sample payload. The delivery goes through the normal dispatcher — signature, headers, and retry behavior are all identical to a real event.

If eventType is omitted, the first event the subscription listens for is used. Returns 202 Accepted once the delivery row is persisted; the outbound POST happens asynchronously.

post/webhooks/subscriptions/{id}/test

Request

  • Base URL: https://services.certseal.com/api/v1
  • URL: https://services.certseal.com/api/v1/webhooks/subscriptions/{id}/test
  • Auth: HTTP bearer

Path parameters

idstring required

Request body

eventType'certificate.issued' | 'certificate.sent' | 'certificate.failed' | 'certificate.viewed'

Stable identifier for an event a subscription can listen to. Sent as the X-CertSeal-Event header on every delivery.

Response

Delivery enqueued. Will be POSTed by the dispatcher worker.

Example response

{
  "sample": {
    "id": "whe_abcd1234EFGH56789ijklMNOP",
    "data": {
      "certificateId": "CERT-2026-003843-000001"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.