Skip to content

Inspect webhook delivery

Guide revision 1 · Needs devices.view, devices.manage

Webhooks deliver eligible events to a configured receiver and record delivery attempts.

Use an active integration application with appropriate event permissions. The receiver must handle signature verification and duplicate events.

  1. Open the application’s webhook configuration.
  2. Enter the receiver URL and enable delivery after reviewing the confirmation.
  3. Copy the newly displayed signing secret once and configure receiver verification.
  4. Inspect delivery status and attempt history.
  5. After fixing a receiver error, confirm Retry for an eligible failed delivery.
  6. Disable delivery when the receiver should stop receiving events.

New eligible events are sent and their attempts are recorded. Enabling starts from the current event head; earlier events are not replayed.

A failed attempt does not prove the receiver never saw the event: uncertain network outcomes can cause duplicates. Receivers must deduplicate. Stale retries or old endpoint revisions can be rejected. Grant changes require token and webhook reconfiguration.

Read the related guide

Report a problem with this page