Adding an Integration
You can create integrations in two ways:- From the rule creation form — click the Add Integration button in the integrations section
- From the integrations list — click the Create Integration button
Webhook
Webhook integrations send an HTTP POST request with rule match data to the URL you provide.1
Select Webhook type
Choose Webhook as the integration type.
2
Enter a name
Give the integration a descriptive name (e.g., “PagerDuty Alerts” or “Internal Monitoring”).
3
Enter the URL
Provide the HTTP endpoint that will receive the POST request.
4
Add custom headers (optional)
Add any headers your endpoint requires — for example, an
Authorization header or a custom X-API-Key. Click Add Header for each key-value pair.5
Save
Click Save to create the integration.
Webhook payload
When a rule fires, Mirador sends an HTTPPOST with a JSON body describing the match. Use it to feed any system that accepts HTTP webhooks — incident management tools, logging pipelines, or custom dashboards.
Each item in
entities identifies one matched object:
The payload identifies what matched, not the trace’s contents — read each entity’s
id and fetch the full record from the REST API.
entities is intentionally a typed list. Today every match produces a trace
entity, but other entity types (for example, fx) may be delivered through the
same array in the future. Branch on type rather than assuming entities[0] is
a trace, so your consumer keeps working as new types are added.Slack
Slack integrations post messages directly to a channel in your workspace.1
Select Slack type
Choose Slack as the integration type.
2
Enter a name
Give the integration a descriptive name (e.g., “Alerts — #ops-alerts”).
3
Connect your Slack workspace
Click Connect Slack. A popup will open asking you to authorize Mirador in your Slack workspace. Approve the connection.
4
Select a channel
After authorization, a dropdown appears listing your Slack channels. Select the channel where you want notifications posted.
5
Save
Click Save to create the integration.
The Slack OAuth connection is per-organization. Once connected, any team member can create Slack integrations using the authorized workspace. You only need to authorize once.
1
Select Email type
Choose Email as the integration type.
2
Enter a name
Give the integration a descriptive name (e.g., “On-call Team Emails”).
3
Add recipients
Enter one or more email addresses. Click Add Recipient to add additional addresses.
4
Save
Click Save to create the integration.
Managing Integrations
Enable / Disable
Toggle an integration on or off without deleting it. Disabled integrations will not receive notifications even if linked to active rules.Editing
Click the edit button on any integration to update its name, URL, channel, recipients, or headers.Deleting
Click the delete button to remove an integration. You’ll be asked to confirm before deletion.You cannot delete an integration that is currently linked to one or more rules. Unlink it from all rules first, then delete.
Next Steps
Rules
Create rules that use your integrations
Activity
See when your integrations fire