Troubleshooting

Solutions for common beeps issues.

Alerts are not appearing

If you’re sending alerts but they’re not showing up:

1. Check the webhook URL — make sure you’re POSTing to the right relay webhook
2. Check the payload — title is required, severity is recommended
3. Check the response — a 200 with an alert_id means beeps received it. A 401 means the webhook key is wrong.
4. For Sentry/Datadog/Axiom, check their delivery logs to see if the webhook is actually firing

Quick test from your terminal:

curl -X POST https://hooks.beeps.dev/YOUR_WEBHOOK_ID \
  -H "Content-Type: application/json" \
  -d '{"title": "Test Alert", "severity": "high"}'

Alerts appear but no one is notified

Check these in order:

1. Does the on-call user have contact methods? Open the dashboard and check. Users without email or SMS configured won’t get anything.
2. Is someone actually on-call? If your schedule has no members, schedule_notify rules have nothing to do.
3. Are the relay rules enabled? Rules are created with enabled: true by default, but check that someone didn’t disable them.
4. Is it the right rule type? A webhook rule posts to a URL — it won’t send email/SMS. You need a schedule_notify rule for that.

No one is on-call

The schedule probably has no members. Add at least one user to the rotation. If there are members but no one shows as on-call, check that the schedule’s startTime and startDay make sense — all times are UTC.

AI agent never responds

1. Check the integration exists — the agent rule references an integrationId. Make sure that integration hasn’t been deleted.
2. Check the API key — test the Devin/Cursor API key directly against their API to confirm it’s valid and has the right permissions.
3. Check the rule is enabled — disabled rules are skipped.
4. Check the rule’s group and order — if the agent rule is in the same group as a schedule_notify rule with a lower order, and a human responds first, the relay may stop before reaching the agent rule.

Relay rules not firing

1. Is the relay receiving alerts? Check the dashboard for alerts on this relay. If there are none, the webhook isn’t being called.
2. Are the rules enabled? Disabled rules are skipped entirely.
3. Check the rule config — each rule type has required fields:
   • schedule_notify needs a scheduleId
   • webhook needs an endpoint and method
   • agent needs an agentType and integrationId
4. Check groups and order — rules in the same group run sequentially by order. If an earlier rule in the same group causes a response, later rules may not fire.

Getting help

If none of the above helps, reach out with:

• Your organization ID
• The relay ID and rule IDs involved
• An example alert payload
• The error message or unexpected behavior you’re seeing