Send Monitor Events to a Webhook

A monitor can send a JSON message to another system — your CRM, a ticketing tool, an automation platform — when it matches, triggers or clears. Add a Send a webhook action, choose its events, send a test, and follow every delivery on the monitor's Activity tab.

Updated September 24, 2026

An alert or an email tells a person. A webhook tells another system: when the monitor matches, triggers or clears, Renable sends a JSON message to an address you choose, and that system decides what to do with it. A common setup is a CRM that turns each message into a task — someone is assigned, checks the import, cleans up the data and logs their time against it.

A webhook is an action like any other, so a monitor can send one alongside an alert and an email, or on its own.

Add a webhook to a monitor#

  1. Open the monitor from the Monitoring page and find the Then section of its Rule tab.
  2. Click + Add action and pick Send a webhook.
  3. Paste the receiving system's address into Webhook address. The system you're connecting gives you this address; it usually carries a token that identifies your account.
  4. Under Send on, tick the events this webhook sends (see below). A new webhook starts with Triggered and Cleared ticked.
  5. Press Send test to check the address works (see below).
  6. Publish the monitor. Nothing is sent until you do.

The address has a few rules, and the field says which one it breaks:

  • It must start with https:// — Renable only sends over an encrypted connection.
  • It can't contain a user name or password (https://name:password@…). If the receiving system needs a secret, it goes in the address's path or query instead, the way most systems hand them out.
  • It can't have a # part, and it can be at most 2,048 characters.
  • It can't contain a space — watch for one pasted at the end — or a character such as |, [ or ] that has to be percent-encoded. Renable never trims or changes the address for you, so remove the space or encode the character.
  • It must be the final address. Renable doesn't follow redirects, so an address that answers with one counts as a failed delivery.

Saving doesn't contact the address — Send test is how you find out whether it works.

A monitor can carry up to 10 webhooks, each with its own address and its own events — one per system you want to tell.

Choose the events#

Each webhook sends only the events you tick. The name in small type beside each box is the event's identifier, which is what the receiving system sees:

  • Matched — every check where the condition holds (monitor.matched) — every import, channel run or reported event where the monitor's condition holds, whether or not the monitor has just triggered. A monitor with no condition matches every one, so with this box ticked the webhook sends a message after every import or every channel run. Not offered on a scheduled check: a schedule has no run to report, and the box says "A scheduled check has no run to report, so its webhook can't send "Matched" (monitor.matched) — choose "Triggered" or "Cleared"."
  • Triggered (monitor.triggered) — the moment the monitor triggers on a catalog or channel. Once per incident, like the email: while the monitor stays triggered, nothing more is sent.
  • Cleared (monitor.cleared) — the moment the monitor clears again on that catalog or channel.

Which to pick depends on what the other side does with them:

  • A task per incident — tick Triggered to open the task and Cleared to close it.
  • A task per import or channel run — tick Matched. Leave the condition empty for every run, or set one to hear only about the runs that need someone.

If the webhook is all you want, leave Raise an alert off. A monitor with no condition and an alert would otherwise show as needing attention on every catalog or channel it watches, for as long as it runs.

Send a test#

Send test appears beside the address once the address is valid. It works on what's on the page right now — you don't need to publish first.

  1. Press Send test. The Send a test webhook dialog opens with the address as you typed it.
  2. Under Catalog or Channel, pick one of the catalogs or channels the monitor watches. Under Event, pick one of the events you ticked — if none is ticked yet, every event the monitor can send is offered.
  3. Press Send. Renable builds the message from that catalog's or channel's real data — its latest import or run, or its newest open event on a monitor that reacts to events — marks it "test": true, and sends it once.

The result shows Delivered or Failed, the HTTP status the address answered with and how long it took, the Response the receiving system sent back, and under Payload sent the exact message. A test is sent once and never retried, and tests don't show on the Activity tab. You can send up to 10 tests a minute across your organization.

Tip: No receiving system yet, or want to see exactly what Renable sends before you connect your CRM? Open webhook.site — it gives you a free, temporary https address and shows every request it receives. Paste that address into Webhook address, press Send test, and read the message and its headers there. Swap in your real address once you're done — anyone who has the webhook.site address can read what it receives.

What Renable sends#

Each event goes to each webhook that subscribes to it as one HTTPS POST with a JSON body. The message says what happened (monitor.triggered and so on), which monitor, organization and project it's about, the catalog or channel with a link to it, the import or channel run with its status and counts, and the values the monitor observed. The field-by-field description is in the Monitor webhook payload reference — hand it to whoever sets up the receiving side.

When the other side doesn't answer#

A delivery counts as done when the address answers with a 2xx status. If it can't be reached, doesn't answer within 10 seconds, or answers with a 5xx, 408 or 429 status, Renable tries again, waiting longer each time, for about an hour. Some answers can't be fixed by trying again, so they fail at once: any other 4xx status (a 404 usually means the address is wrong, a 401 or 403 that its token is), a redirect, and an address that points into a private network.

When a delivery fails for good, the monitor raises an Error alert saying the webhook delivery failed and why. It shows on the dashboard and on the monitor's Alerts tab. There's one such alert per webhook, whatever the number of failures — two webhooks to the same service, such as two Slack channels, each get their own — and it clears on its own as soon as a delivery to that webhook succeeds again. It never holds a publish, and it never marks a catalog or channel as needing attention: it's about the webhook, not about your data.

A failing webhook doesn't make the monitor Triggered — that's still about its condition. The monitor's card on the Monitoring page turns red and adds webhook delivery failing. The status line on the monitor also names the webhook and its last answer — "hooks.slack.com · webhook 2 answered 503 after 8 attempts", or "could not be reached" — beside whatever the condition says, All clear included. webhook 2 is the webhook's place among the monitor's Send a webhook actions on the Rule tab.

  • Fix the receiving side, and the next delivery clears the alert. Until the next event there's nothing to deliver, so you can archive the alert once you've checked with Send test that the address works again.
  • Remove the failing webhook, or point it at another address, and publish: its alert clears — even when another webhook of the monitor sends to the same host.
  • Pausing the monitor with its switch stops its deliveries — one still waiting for a retry is Skipped instead of sent — and clears the alert right away. Archiving the monitor does the same. Removing a webhook or changing its address stops the retries to the old address the same way.
  • A failed message isn't sent again later. Its content stays on the Activity tab, so whatever it would have created can be made by hand.

Follow every delivery on the Activity tab#

The monitor's Activity tab lists what the monitor did, newest first: each time it matched, triggered or cleared (Matched, Triggered, Cleared), the catalog or channel, the import, run or event it was about, and a summary of its Deliveries. Open an entry to see each delivery it made — every webhook and every email — with its status, the HTTP status the address answered, how long it Took, how many Attempts it needed, when the last attempt was and the start of the answer. Show payload shows the exact message a webhook receives.

  • Triggered and Cleared are listed for every monitor, with or without a webhook. Matched is listed only when a webhook sends it.
  • The tab keeps the newest 50 entries per monitor.
  • A webhook delivery is Queued, Retrying, Delivered, Failed or Skipped — the monitor was paused or archived, or no longer sends that webhook, before the delivery went out. An email is Sent, Skipped — it had no verified recipient, was already sent that day, or the monitor's emails changed before it went out — or Failed.
  • A webhook shows as its address's host and its place among the monitor's webhooks (hooks.example.com · webhook 2), so two webhooks to one service read apart. The number is its place when the delivery was made. The rest of an address often holds the receiving system's secret key, so Renable never shows it outside the webhook's own setting — not on this tab and not in an alert.

The Alerts tab is different: it shows the monitor's alerts that are open right now. The Activity tab is the history.

Let Aimée add it#

On the monitor, or on the Monitoring page, tell Aimée what you want: "Also send a webhook to https://hooks.example.com/renable when it triggers." She adds Send a webhook to the monitor's draft with the events you asked for — and asks for the address if you didn't give one. Publish as usual, and use Send test on the Rule tab to check the address.

Good to know#

  • The address is visible to your team. Anyone in your organization who can open the monitor sees its webhook addresses, token included, and so do its version history and Aimée. If a token leaks, create a new one in the receiving system and replace the address.
  • Messages aren't signed. The token in the address is what tells the receiving system the message is yours.
  • Each message has its own delivery id. Retries of one delivery carry the same id, so the receiving system can recognise a message it has already handled — see the payload reference.
  • Messages can arrive out of order. Each one is sent and retried on its own, so a Cleared can overtake the Triggered before it. The message carries the time it happened; sort on that.

Related articles#