Webhook Events and Configuration



Webhooks send real-time HTTP POST requests to your server when events occur in Suhep.

Setting Up Webhooks



  • 1.Go to Admin → API Keys → Webhooks
  • 2.Click + Add Webhook
  • 3.Enter your endpoint URL
  • 4.Select events to subscribe to
  • 5.Click Save


    • Available Events



    | Event | Trigger | |-------|---------| | ticket.created | New ticket submitted | | ticket.updated | Status, priority, or assignment changed | | ticket.resolved | Ticket marked as resolved | | ticket.reply | New reply added | | article.created | KB article published | | article.updated | KB article modified |

    Payload Format



    json
    {
  "event": "ticket.created",
  "timestamp": "2026-03-28T10:00:00Z",
  "data": {
    "id": "ticket-123",
    "subject": "...",
    "status": "open"
  }
}


    Verification



    Each webhook includes a signature header for verification: 
    X-Suhep-Signature: sha256=...


    Retry Policy



    Failed deliveries (non-2xx response) are retried:
  • •3 attempts with exponential backoff
  • •After 3 failures, the webhook is marked as unhealthy