Skip to main content

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
See Webhook Subscriptions for more details.

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