Incidentary Docs

Slack

Send incident notifications to a Slack channel when an incident is assembled.

Slack Integration

The Slack integration sends a notification to a channel when an incident is assembled. The notification includes the incident URL, the first confirmed break, affected services, and coverage information.

What the notification contains

[Incidentary] payments-api incident — shared incident timeline
First confirmed break: payments HTTP_IN 503
Affected services: edge, api, payments
Coverage: partial coverage · 1 gap visible
Captured steps: 6
View and annotate incident timeline >>

The notification links to a publicly accessible incident URL. Anyone in the channel can open it without an Incidentary account.

Setup

Step 1: Create a Slack app and get a webhook URL

  1. Go to api.slack.com/apps and click Create New App
  2. Choose From scratch
  3. Name the app Incidentary and select your workspace
  4. Under Features, select Incoming Webhooks
  5. Toggle Activate Incoming Webhooks to On
  6. Click Add New Webhook to Workspace
  7. Select the channel where incident notifications should be posted
  8. Copy the webhook URL — it starts with https://hooks.slack.com/services/...

Step 2: Add the webhook URL in Incidentary

  1. In the Incidentary dashboard, go to Settings → Integrations → Slack
  2. Paste the webhook URL
  3. Click Save

Step 3: Test the integration

Click Send Test Notification in the integration settings. A test message labeled [Incidentary][TEST] will appear in your Slack channel. If it does not appear within 30 seconds, verify the webhook URL and check that the Slack app has access to the channel.

Thread replies and annotations (Team plan)

On the Team plan, replies to the incident notification thread are captured as annotations on the incident timeline. Team members can comment in Slack during an incident and those comments appear alongside the causal chain.

To enable this:

  1. Configure the Slack Events API subscription in your Slack app
  2. Set the request URL to: https://api.incidentary.com/api/v1/integrations/slack/events
  3. Subscribe to the message.channels event

Slash command (Team plan)

The /incidentary status command shows the latest open incident in the current channel.

To add the slash command to your Slack app:

  1. Under Features, select Slash Commands
  2. Click Create New Command
  3. Command: /incidentary
  4. Request URL: https://api.incidentary.com/api/v1/integrations/slack/commands
  5. Short description: Show latest Incidentary incident

/incidentary status — posts the latest open incident ephemerally (visible only to you)

/incidentary status share — posts the latest open incident to the channel

OpenTelemetry

Send traces from your existing OpenTelemetry instrumentation to Incidentary with zero SDK installation and zero code changes.

PagerDuty

Trigger incident assembly when a PagerDuty alert fires, and post the shared URL back to the incident.

On this page

Slack IntegrationWhat the notification containsSetupStep 1: Create a Slack app and get a webhook URLStep 2: Add the webhook URL in IncidentaryStep 3: Test the integrationThread replies and annotations (Team plan)Slash command (Team plan)