Skip to main content

ZenDuty Webhook

The ZenDuty webhook integration lets ZenDuty push alerts into NudgeBee. Each alert becomes a NudgeBee event that can be triaged, correlated with cluster telemetry, and used to trigger automations.

Step 1: Create the Webhook in NudgeBee​

  1. Navigate to Admin > Integrations > Webhooks.
  2. Select Zenduty Webhook and click Add Zenduty Webhook Account.
  3. Fill in the form:
    • Name of ZenDuty Webhook * (Required) — a descriptive name, e.g. zenduty-prod.
    • Select Account * (Required) — the NudgeBee account that should receive these events.
  4. Click Save.

NudgeBee generates a unique webhook URL for the integration, in the same form used by the other inbound webhooks:

https://<your-nudgebee-domain>/api/webhooks/zenduty_webhook?token=<generated-token>
  1. Copy the webhook URL. You will paste it into ZenDuty in the next step.
caution

The token query parameter authenticates the sender. Treat the full URL as a secret — anyone holding it can create events in your tenant. If it leaks, delete the integration and create a new one to rotate the token.

The ZenDuty Webhook tile in the Webhooks tab of the integrations catalog

The ZenDuty Webhook form, which takes only a name and an account

Step 2: Point ZenDuty at the URL​

Create a ZenDuty outgoing webhook in ZenDuty and set its destination to the URL from Step 1:

  • Method: POST
  • Content-Type: application/json
  • URL: the NudgeBee webhook URL, token included

Then attach it to the alert rules whose notifications you want in NudgeBee. Send a test notification if ZenDuty offers one.

Reference: ZenDuty outgoing webhook documentation

Step 3: Verify​

  1. Trigger a test notification from ZenDuty, or wait for a real alert to fire.
  2. In NudgeBee, open Troubleshoot > Events. The event should appear within a few seconds.
  3. Open it and confirm the alert name and severity carried across, and that the impacted workload is linked where the payload identifies one.

Troubleshooting​

SymptomLikely CauseFix
No event appearsZenDuty cannot reach the NudgeBee URLConfirm the NudgeBee endpoint is reachable from ZenDuty's notification sender. Check egress rules on both sides.
401 or 403 from the endpointThe token parameter is missing or wrongRe-copy the full URL from the integration — the token is part of the query string, and is easy to drop when pasting.
Event appears with no workload linkedThe payload carries no identifier NudgeBee can matchInclude the resource, host or service name in the alert payload so it can be matched to a workload.
Duplicate events for one alertTwo notification rules point at the same URLConsolidate them in ZenDuty, or use separate integrations per environment.
Alerts never resolve in NudgeBeeOnly firing notifications are being sentConfigure ZenDuty to send resolution notifications to the same destination.