Documentation

Infrastructure Control (ICP) · Reference

Webhooks

Get ICP events pushed to your own systems in real time — subscribe a URL to ticket and device events, verify with a signing secret.

Webhooks push ICP events to your systems as they happen — so a new or escalated ticket can open a chat message, update a dashboard, or drive a workflow without polling. Outbound webhooks for ticket and device events ship with the platform alongside its REST API.

Subscribe

An admin registers an endpoint (a URL) and the events it should receive:

EventFires when
ticket.openedA ticket is created
alert.ticketAn alert opened a ticket
ticket.escalatedA ticket is escalated
ticket.re-escalatedAn escalated ticket escalates again
command.failedA device command failed
*Subscribe to all events

Verify deliveries

Each endpoint gets a signing secret, generated once, so you can verify that a delivery really came from ICP. The endpoint list masks the secret after creation.

Manage endpoints

  • Enable / disable an endpoint
  • Test-deliver on demand to check your receiver
  • See last-delivery status and a failure count

Warning

Always verify the signature on an incoming webhook before acting on it, and respond quickly (do heavy work asynchronously). Endpoints that keep failing are surfaced by their failure count so you can fix or disable them.

Need a hand with Infrastructure Control (ICP)?Talk to our team →