How to use the Webhooks screen (Integrations)
Outbound webhooks: HTTPS endpoints that receive signed events, with retry and dead-letter, and the newest deliveries listed under them.
Have questions or need step-by-step guidance on this topic?
Step-by-Step Procedure
Open the page
Sign in as an administrator and use Admin sidebar → Integrations → Webhooks, or go to /admin/integrations/webhooks. The heading reads "Webhooks".
Know where the data comes from
This page reads i8_webhook_endpoints and i8_webhook_deliveries. KPI tiles Endpoints, Active, "Waiting / retrying", Dead-lettered, "Signing configured". Rows of Type ENDPOINT and DELIVERY.
Register an endpoint
New Record (Super Administrator only): "Endpoint URL (https)", Description, "Events (comma separated)". The URL must be a public https host; internal names, private addresses, ports and credentials in the URL are refused. The signing secret is shown once in the banner.
Test it
Row icon "Send a signed test event" delivers a webhook.test event and reports the real outcome; a failing receiver is reported as NOT delivered.
Operate
"Rotate signing secret" issues a new secret (shown once); "Re-queue dead-lettered deliveries" replays an endpoint's dead deliveries; the table button "Retry due deliveries now" attempts everything whose retry time has come. The trash icon disables an endpoint; its history is kept.
Use the shared controls
Use the shared controls: the search box ("Search records, hashes, DIDs...") filters rows by any text; "Status:" offers ALL, ACTIVE, DISABLED, DELIVERED, RETRYING, PENDING, DEAD; "Page Size:" sets 10, 15, 25 or 50 rows; Refresh reloads; Export saves the rows currently loaded as a JSON file; New Record opens the form described above. The line "Data:" under the heading names the real source.
Endpoints deliver signed events, failures are visible, and nothing is reported delivered unless the receiver answered 2xx.
Troubleshooting & Failure Modes
Was this guide helpful?
Help us refine our platform documentation