Skip to main content

​
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)
The OpsGenie API key is required at creation time for the webhook to function properly. It cannot be changed after creation.
See Webhook Subscriptions for more details.

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