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

# incident.io

> Incident management platform

## Overview

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

## Prerequisites

* Administrative access to your incident.io 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 incident.io

### Step 2: Configure Webhook

1. TierZero will display a webhook URL. Copy it
2. In incident.io, 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., "incident.io Production")
   * **Remote ID**: The integration identifier from incident.io
   * **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

## Using with Incident Agent

incident.io 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 incident.io

## Troubleshooting

### Incidents Not Triggering

* Verify the webhook URL is correct in incident.io
* Check that the webhook secret matches
* Ensure an Alert Agent or Incident Agent is configured to respond