> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tierzero.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Rootly

> Incident management and response platform

## 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

Configure webhook subscriptions from the TierZero dashboard to receive these events.

## 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](/features/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