Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rootly.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Once Datadog is connected to Rootly, you can forward monitor alerts to Rootly via a webhook. Alerts received in Rootly can be routed to a Slack channel, used to page on-call responders, or trigger incident workflows automatically.
Complete the Installation before configuring alerts. You must have Datadog connected to Rootly before webhooks will authenticate.

​
Step 1: Set Up the Webhook in Datadog

1

Install the Webhooks integration

In Datadog, navigate to Integrations, search for Webhooks, and click Install.
Installing the Webhooks integration in Datadog
2

Create a new webhook

Switch to the Configuration tab and click + New to add a webhook.
Configuration tab in Datadog Webhooks showing the New button
3

Configure the webhook

Fill in the following fields:Name — give the webhook a descriptive name (e.g., Rootly_Alerts)URL — enter:
https://webhooks.rootly.com/webhooks/incoming/datadog_webhooks
Payload — choose based on your use case:
Use this payload for standard alerts that appear in Rootly’s Alerts page without paging anyone.
{
  "id": "$ID",
  "body": "$EVENT_MSG",
  "last_updated": "$LAST_UPDATED",
  "event_type": "$EVENT_TYPE",
  "title": "$EVENT_TITLE",
  "alert_id": "$ALERT_ID",
  "alert_metric": "$ALERT_METRIC",
  "alert_priority": "$ALERT_PRIORITY",
  "alert_query": "$ALERT_QUERY",
  "alert_scope": "$ALERT_SCOPE",
  "alert_status": "$ALERT_STATUS",
  "alert_title": "$ALERT_TITLE",
  "alert_transition": "$ALERT_TRANSITION",
  "alert_type": "$ALERT_TYPE",
  "date": "$DATE",
  "org": {"id": "$ORG_ID", "name": "$ORG_NAME"}
}
The only difference between these payloads is the notification_target object. Including it tells Rootly who to page when the alert is received.
4

Add the custom header

Check the Custom Headers box and add the following, replacing the value with your Rootly webhook secret:
{
  "secret": "<YOUR_ROOTLY_WEBHOOK_SECRET>"
}
To find your secret:
  1. In Rootly, go to Alerts → Sources → Datadog and click Configure
Configure button on the Datadog alert source in Rootly
  1. Find the Connection Instructions panel on the right
Connection Instructions panel showing the webhook URL and secret
  1. Copy the secret value from the Custom Headers section
Custom Headers section showing the secret to copy
5

Save the webhook

Click Save.

​
Step 2: Attach the Webhook to a Monitor

1

Open a monitor

In Datadog, navigate to Monitors → New Monitor and choose a monitor type, or open an existing monitor to edit it.
2

Add the webhook to notifications

In the Configure notifications and automations section, reference your webhook using @webhook-<WEBHOOK_NAME> syntax (e.g., @webhook-Rootly_Alerts).
3

Test and save

Click Test Notifications to confirm the alert reaches Rootly, then save the monitor.
Datadog monitor notification configuration with webhook
Successful test notification in Datadog
Verify the alert appeared on the Alerts page in Rootly.

​
Step 3: Build Alert Workflows in Rootly

With alerts flowing into Rootly, create a workflow that reacts to them. Alert workflows let you check alert fields, apply conditions, and trigger automated actions like creating an incident or notifying responders.
1

Open Workflows

Navigate to Workflows in Rootly and click Create Workflow.
Create Workflow button in Rootly's Workflows page
2

Choose Alert workflow type

Select Alert as the workflow type. This workflow triggers whenever Rootly receives an alert from Datadog.
Selecting Alert as the workflow type in Rootly
3

Set the trigger

Select Alert Created to fire on new alerts, or Alert Status Updated to react when an existing alert changes.
Available triggers: Alert Created fires when a new alert is received. Alert Status Updated fires when an existing alert changes state.
4

Add conditions

Filter which alerts should trigger this workflow. Common patterns:
Add a condition where Source is Datadog to scope the workflow to Datadog alerts only.
Use Datadog payload fields like alert_priority, alert_status, alert_type, and alert_title to build precise conditions.
5

Add actions

Add one or more actions to execute when the workflow fires:
ActionUse case
Create IncidentAuto-create an incident from the alert
Page Rootly On-CallPage the responsible team or escalation policy
Send Slack MessageNotify a channel about the alert
Send SMS or EmailAlert responders directly
You can chain multiple actions for a complete response process — for example, create an incident and then send a Slack message in the same workflow.
6

Save the workflow

Name the workflow (e.g., Create Incident from Datadog P1 Alert) and click Create Workflow.
Save and create the alert workflow in Rootly

​
Verify the Workflow

After saving the workflow:
  1. Return to Datadog and trigger a test alert from your monitor by clicking Test Notifications
  2. Confirm the workflow activates in Rootly and performs the expected actions
  3. View the run log under Workflows → History in Rootly
You have successfully built a Datadog alert workflow in Rootly!

​
Frequently Asked Questions

Verify the webhook URL is exactly https://webhooks.rootly.com/webhooks/incoming/datadog_webhooks. Confirm the Custom Headers secret value matches what is shown in Alerts → Sources → Datadog → Configure in Rootly. Check that the Datadog integration is still connected under Configuration → Integrations.
Open the resource (User, Team, Escalation Policy, or Service) in Rootly and click Edit. The resource ID appears in the URL or in the edit form. Copy it and paste it into the id field of the paging payload.
Yes. Create one webhook and attach it to as many monitors as needed by adding @webhook-<WEBHOOK_NAME> to each monitor’s notification body. Each alert will appear separately in Rootly’s Alerts page.
Alert workflows in Rootly support Alert Created (fires on new alerts) and Alert Status Updated (fires when an existing alert changes). Use conditions to filter by source (Datadog), payload fields like alert_priority or alert_title, or alert status.
By default, Rootly will only page for CRITICAL alerts from Datadog. If your team would like to enable paging for WARNING alerts, contact Rootly Support to have the feature enabled.