Skip to main content

Quickstart: Receive Webhooks

Follow these steps to start monitoring heartbeats with Seiri.

Step 1: Get your endpoint​

  1. Open Core → Webhooks in cloud.seiri.app.
  2. Create a webhook (Periodic, Cron, or On-Demand).
  3. Copy the full URL from the ENDPOINT column (or webhook details).

The endpoint ID looks like acme-demo:YOUR_REF. The ingest URL is always on ping.seiri.app.

Step 2: Send a test ping​

curl -fsS -m 10 https://ping.seiri.app/webhook/acme-demo:YOUR_REF/success

Optional JSON body (POST):

curl -X POST https://ping.seiri.app/webhook/acme-demo:YOUR_REF/success \
  -H "Content-Type: application/json" \
  -d '{"event_id":"123","status":"success"}'

Step 3: Verify delivery​

  • Open webhook stats (bar-chart icon) or webhook details.
  • Successful check-ins appear as healthy / ok; failures and misses are highlighted.

Step 4: Configure alerts (optional)​

Attach notification channels (Slack, Discord, Teams, Telegram, Ntfy, email, webhook) when creating or editing the webhook.

Tip: Start with a small test ping before wiring production jobs.