Webhook configuration for real-time events

Webhook configuration

Certorix can send real‑time HTTP callbacks (webhooks) to your server when certain events occur.

Available webhook events

• diagnostic.completed – Fired when a customer reaches a Solution or Result node.
• diagnostic.abandoned – Fired when a session expires or is abandoned for more than 30 minutes.
• ticket.created – Fired when a ticket is created via the widget contact form.
• fact.certified – Fired when a fact receives a VNT token.
• tree.published – Fired when a tree is published.

Configuring a webhook

1. Go to API & Webhooks in the sidebar (under MCP / API).
2. Click Add webhook.
3. Enter your endpoint URL (must be HTTPS).
4. Select which events to subscribe to.
5. Optional: Add a secret for HMAC signature verification.
6. Click Save. Certorix sends a verification request to your endpoint (must return 200).

Webhook payload example

{
  "event": "diagnostic.completed",
  "timestamp": "2026-05-02T10:30:00Z",
  "data": {
    "sessionId": "sess_123abc",
    "treeId": "tree_456def",
    "nodeId": "sol_789ghi",
    "answers": [
      {"nodeId": "q1", "answer": "Yes"},
      {"nodeId": "q2", "answer": "iPhone"}
    ]
  }
}

Retry policy

If your endpoint returns an error (non‑2xx), Certorix retries after 5 seconds, then 30 seconds, then 5 minutes, then 1 hour. After 5 failures, the webhook is disabled and an email is sent to admins.