FireHydrant

Overview

FireHydrant is an incident management platform that helps teams respond to and learn from incidents. The Shortcut integration creates Stories for incident follow-up items, ensuring post-incident work is tracked and completed.

Key Features

• Automatic Story Creation: Follow-up items from incident retrospectives become Stories
• Incident Linking: Stories link back to the incident timeline in FireHydrant
• Priority Mapping: Incident severity maps to Story priority
• Team Routing: Stories are assigned to the appropriate team based on incident ownership

Setting Up the Integration

1. In FireHydrant, go to Integrations > Ticketing
2. Select Shortcut and click Add Integration
3. Enter your Shortcut API token
4. Configure default settings:
   • Workspace
   • Default Team
   • Workflow
   • Labels

Generate a Shortcut API token from Settings > API Tokens in your workspace.

Using the Integration

During Incidents

While managing an incident in FireHydrant:

• Add follow-up items as they’re identified
• These items sync to Shortcut as Stories after the incident

Post-Incident

After an incident is resolved:

1. Review follow-up items in the retrospective
2. Stories are created automatically or on-demand
3. Track remediation work through your normal workflow
4. Story completion updates FireHydrant

Incident Context

Each Story created from FireHydrant includes:

• Incident title and severity
• Link to the incident in FireHydrant
• Related timeline events
• Assigned responders

Best Practices

• Use a dedicated “Incident Follow-up” label
• Create an Epic for major incidents to group related Stories
• Link Stories to post-mortems in your Docs