Skip to main content

​
Overview

Connect Rootly to enable TierZero to receive incident events and participate in your incident response workflow. TierZero can automatically investigate incidents reported through Rootly.

​
Prerequisites

  • Administrative access to your Rootly account
  • Permission to configure webhook integrations

​
Setup Instructions

​
Step 1: Navigate to Integration Settings

  1. Log into your TierZero dashboard
  2. Go to Settings → Integrations
  3. Click Connect next to Rootly

​
Step 2: Configure Webhook

  1. TierZero will display a webhook URL. Copy it
  2. In Rootly, configure a webhook pointing to the TierZero URL
  3. Enter the webhook secret provided by TierZero
  4. Select the incident events to forward

​
Step 3: Create a Webhook Subscription

  1. Back in TierZero, enter the webhook details:
    • Name: A descriptive name (e.g., “Rootly Production”)
    • Remote ID: The integration identifier from Rootly
    • Secret: The webhook authentication secret
See Webhook Subscriptions for more details.

​
What TierZero Accesses

  • Incident lifecycle events: Creation, updates, status changes
  • Incident metadata: Severity, affected services, responders
  • Dashboard content: Rootly dashboard panels and data

​
Using with Incident Agent

Rootly incidents can trigger the Incident Agent, which auto-joins the corresponding Slack channel and begins real-time investigation.

​
Security

  • Webhook signatures are validated on every incoming event
  • Secrets are encrypted at rest
  • Revoke by removing the webhook in Rootly

​
Troubleshooting

​
Incidents Not Triggering

  • Verify the webhook URL is correct in Rootly
  • Check that the webhook secret matches
  • Ensure an Alert Agent or Incident Agent is configured to respond