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

# incident.io Integration

> Connect incident.io to Corelayer to receive alerts and enable intelligent incident debugging and response.

## Prerequisites

* An incident.io account
* Permission to configure webhooks in your incident.io settings

## Step-by-Step Setup

### 1. Navigate to Integrations

In your Corelayer dashboard, go to the **Integrations** page.

### 2. Add incident.io Integration

Click the **Add Integration** button and select **incident.io** from the list of available integrations.

### 3. Copy the Webhook URL

Corelayer will provide a webhook URL. Copy this URL for use in the next step.

### 4. Configure the Webhook in incident.io

In your incident.io dashboard:

1. Go to your webhook settings
2. Add a new webhook endpoint with the URL provided by Corelayer
3. Subscribe to the following event types:
   * `public_alert.alert_created_v1`
   * `private_alert.alert_created_v1`
4. Save the webhook configuration
5. Copy the **Signing Secret** generated by incident.io

### 5. Enter the Webhook Secret

Paste the signing secret into the Corelayer setup form and click **Save**.

### 6. Add incident.io to Your Service Maps

When configuring your Corelayer Service Maps, add incident.io as an alert source. incident.io is configured at the map level, meaning alerts are routed based on your overall service map configuration.

## What Corelayer Can Do With incident.io

Once connected, Corelayer will:

* Receive real-time alerts when incidents are created in incident.io
* Automatically start debugging when public or private alerts are triggered
* Pull alert context and correlate with other integrations for root-cause analysis
* Provide intelligent summaries and suggested remediation steps

## Managing Your Integration

### Disconnecting

To disconnect your incident.io integration:

1. Navigate to Settings > Integrations
2. Find your incident.io integration and click **Uninstall**
3. Confirm the uninstallation
4. Remove the webhook endpoint from your incident.io settings

## Troubleshooting

### Integration Not Working?

* Verify the webhook URL is correctly configured in incident.io
* Ensure the signing secret matches between incident.io and Corelayer
* Check that you've subscribed to the correct event types (`public_alert.alert_created_v1` and `private_alert.alert_created_v1`)
* Confirm your incident.io account is active and generating alerts

Need help? [Contact support](mailto:support@corelayer.com) for assistance with your incident.io integration.