FireHydrant
Enable your AI agent to surface active incidents to customers and let CoPilot create incidents, add notes, and page the on-call team via FireHydrant.
5 min read
Updated October 2026
Overview
The FireHydrant integration connects ChatSpark to your FireHydrant account. Read actions are available in the customer-facing AI agent widget so customers can check incident status. Write actions are available to CoPilot only.
Your support team can create incidents, add notes, and page the on-call team directly from CoPilot during an active incident.
Available Actions
Available actions depend on your agent type and plan. Customer-facing actions serve customers. Internal team actions are for authenticated team use. AI CoPilot is Enterprise-only. Plus enables up to 5 actions per agent, Pro enables 40, and Enterprise has no enabled-action limit.
| Action | Description | Audience |
|---|---|---|
| Add Incident Note | Add a note to an open FireHydrant incident. ONLY when the agent explicitly asks to add a note, comment, or update to an open incident. | Internal team |
| Create Incident | Create a new incident in FireHydrant. ONLY when the agent explicitly asks to create or open a FireHydrant incident. Do NOT use this to check existing incident status. | Internal team |
| Get Active Incidents | Get active incidents from FireHydrant. Call this when a customer asks whether there is an active incident affecting a service or what is currently being worked on. | Customer-facing |
| Get Incident Details | Get details for a specific FireHydrant incident. Call this when a customer asks for the current status or details of a specific incident. | Customer-facing |
| Page On Call | Page the on-call team or escalation policy via FireHydrant Signals. ONLY when the agent explicitly asks to page, alert, notify, or escalate to the on-call team. Do NOT use this to check who is on call. | Internal team |
Prerequisites
Before setting up the FireHydrant integration, you'll need:
- A FireHydrant account
- At least one team configured in FireHydrant
- Admin access to generate API keys
Setup Instructions
Step 1: Generate an API Key
- Log in to FireHydrant at app.firehydrant.io
- Go to Organization Settings and select API Keys
- Click New API Key and give it a name
- Copy the key
Step 2: Enable in ChatSpark
- In ChatSpark, go to AI Actions
- Find FireHydrant in the Library and click Enable
- Enter your API Key
- Click Save
Configuration Fields
| Field | Description | Example |
|---|---|---|
| API Key | Your FireHydrant API key | xxx |
Testing Your Integration
Test customer-facing actions in your AI agent widget:
- “Is there an active incident?”
- “What is the status of incident inc-abc?”
Test CoPilot actions in the CoPilot browser extension:
- “Create a new FireHydrant incident for the payment service”
- “Add a note to incident inc-abc”
- “Page the engineering team”
Troubleshooting
Unauthorized
Check that the API key is still active. You can verify this in your FireHydrant Organization Settings under API Keys.
Incident not found
Confirm the incident ID is correct. FireHydrant incident IDs use the format inc-xxxxxxxx.
Cannot page on-call
Make sure on-call schedules are configured in FireHydrant and the target team ID is valid.