Trigger manual webhook event to registered subscriptions

Triggers a manual webhook event for the specified event type. Publishes a lightweight event message to Pub/Sub. The consumer will look up active webhooks for the tenant and deliver the event to them asynchronously.

Schema Validation:

Each event type has a corresponding JSON Schema that defines the required structure for eventData. The eventData payload is validated against the schema for the specified eventType. Invalid payloads will return a 400 Bad Request with detailed validation error messages.

Supported Event Types and Schemas:

• credential_workflow.status.changed → https://schemas.certifyos.com/webhook-events/credential-workflow-status-changed.schema.json

• facility_credential_workflow.status.changed → https://schemas.certifyos.com/webhook-events/facility-credential-workflow-status-changed.schema.json

What the webhook receiver will receive:

HTTP Headers:

• Content-Type: application/json

• User-Agent: CertifyOS-Webhook-Delivery/1.0

• Idempotency-Key: <SHA-256 hash> - A unique key for deduplication (same key across retries)

• Any custom headers configured in the webhook subscription

Request Body (JSON):

{
  "eventType": "credential_workflow.status.changed",
  "timestamp": "2024-01-20T09:15:00Z",
  "data": { /* your eventData payload */ }
}

The data field contains the eventData from your request payload. The timestamp is automatically set to the current time when the event is delivered.