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

# Incident.io Integration

> Integrate with incident.io to give Annie read access to your incidents, alerts, postmortems, and workflows.

# Incident.io Integration

Connect incident.io to give Annie access to your incident management data. During investigations, Annie can correlate alerts with incidents, review postmortems, and surface actionable context from your incident history.

## Setup Guide

1. Go to the [Incident.io integration page](https://app.anyshift.io/integrations/incidents-management/incident-io)
2. Click **New token** to add your incident.io API key

### API Key

Generate an API key from your incident.io dashboard under **Settings > API keys**. The key should have read access to the resources you want Annie to use.

### Required Permissions

When creating the API key, enable the following permission groups:

* **View data, like public incidents and organization settings** (18 scopes) - Access incidents, alerts, postmortems, users, and organization data
* **View catalog types and entries** (3 scopes) - Browse catalog entries for service and team context

## How It Works

Once connected, Annie's AI agent can:

* **Investigate incidents** - Fetch incident details, timelines, and status updates
* **Correlate alerts** - Link alerts to incidents and trace alert routes
* **Review postmortems** - Access postmortem content and learnings from past incidents
* **Inspect workflows** - View incident response workflows
* **Browse the catalog** - Query catalog entries for service and team context
* **Track follow-ups** - List follow-up actions from incidents
* **View roles & users** - List available incident roles and responders

## Slack Bot in Incident Channels

To give Annie visibility into your incident channels, configure incident.io to automatically invite the Annie Slack bot to new incident channels:

1. In incident.io, go to **Settings > Workflows**
2. Add or edit a workflow triggered on incident creation
3. Add the **Invite a Slack bot user to an incident channel** step
4. Select **Annie** as the bot user

This ensures Annie is present in every incident channel and can follow conversations, provide context, and assist during active incidents.

## Webhooks

Click **New webhook** to configure a webhook for real-time incident updates. This allows Annie to react to incidents as they happen.