Guide

Create a Webhook Source

Create a webhook-backed Beacon source with a real sample and a clean receiver URL.

Before you start

  • Have one real sample payload from the monitoring tool.
  • Know whether this source should map to one fixed destination or route from payload data.

Do this

  1. In Alerts, create a new source and choose the webhook source kind.
  2. Give the source a name operators will recognize during an incident.
  3. Paste a real sample payload or capture one from live traffic.
  4. Let Beacon detect the provider from the sample, or choose the provider profile yourself if detection is wrong.
  5. Save the source and copy the receiver URL into the sending tool.
  6. Send one test event so you have a payload to validate before you work on routing.

Check it worked

  • The source saves successfully.
  • The sample is attached to the source.
  • The source shows the provider you expected.
  • The external tool can send a test event to the receiver URL.

If it does not work

  • If provider detection is wrong, correct it before you map fields.
  • If the receiver test fails, copy the exact URL again from the source detail page.
  • If the payload shape changes across alerts, choose a cleaner representative sample before you continue.

Next