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

# OpsGenie

> Alert management and on-call scheduling

## Overview

Connect OpsGenie to enable TierZero to receive alert events and participate in your alert response workflow. TierZero can automatically investigate alerts routed through OpsGenie.

## Prerequisites

* Administrative access to your OpsGenie account
* Permission to create API 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 OpsGenie

### Step 2: Create a Webhook Integration in OpsGenie

1. In OpsGenie, go to **Settings → Integrations → Add Integration**
2. Select **Webhook** integration type
3. Copy the webhook URL provided by TierZero
4. Configure the webhook to send alert events
5. Copy the **Integration ID** and **API key** from OpsGenie

### Step 3: Create a Webhook Subscription in TierZero

1. Back in TierZero, enter the webhook details:
   * **Name**: A descriptive name (e.g., "OpsGenie Production Alerts")
   * **Remote ID**: The Integration ID from OpsGenie
   * **Secret**: The webhook authentication secret
   * **API Key**: The OpsGenie API key (required for alert enrichment)

<Warning>
  The OpsGenie API key is required at creation time for the webhook to function properly. It cannot be changed after creation.
</Warning>

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

## What TierZero Accesses

* **Alert events**: Alert creation, acknowledgment, closure
* **Alert metadata**: Severity, description, tags, affected services
* **Alert enrichment**: Additional context fetched via the OpsGenie API key

## Using with Alert Agents

After creating a webhook subscription, connect it to an Alert Agent:

1. Create or edit an Alert Agent
2. Select **Webhook** as the alert source
3. Choose your OpsGenie webhook subscription
4. TierZero will automatically investigate alerts

## API Reference

For programmatic webhook management, see the [OpsGenie Webhook API](/references/tz_api) reference.

## Security

* Webhook signatures are validated on every incoming event
* API keys and secrets are encrypted at rest and never returned in API responses
* Revoke by removing the webhook integration in OpsGenie

## Troubleshooting

### Alerts Not Triggering Investigations

* Verify the webhook URL is correct in OpsGenie
* Check that both the secret and API key are configured
* Ensure an Alert Agent is connected to the webhook subscription
* Review OpsGenie's integration logs for delivery errors