Confluence & Notion

Automatically create postmortem pages in Confluence or Notion after an incident is resolved, documenting the timeline, root cause, and action items.

Overview

Once an incident is marked as resolved in Batida, a postmortem document is generated and published to your configured knowledge base. This ensures every incident is documented without requiring manual effort from responders.

Postmortem templates

You can customize the postmortem template used for generated pages. Templates support variables like \<%= incident.title %>, \<%= incident.id %>, \<%= incident.duration %>, and \<%= timeline %> for dynamic content.

Confluence setup

Prerequisites

• A Confluence Cloud site (server/data center is not supported)
• An API token generated from Atlassian account settings

Configuration

1. Go to Settings > Integrations > Confluence in the Batida dashboard.
2. Enter your Confluence site URL (e.g., https://your-team.atlassian.net/wiki).
3. Enter your Confluence email and API token.
4. Select the parent page where postmortem pages will be created.
5. Choose the postmortem template (default or custom).
6. Click Save & Verify.

Site URL:    https://your-team.atlassian.net/wiki
Email:       you@company.com
API Token:   ATATT3xFfGF0...
Parent Page: Postmortems (ID: 123456)

Generated page structure

# Postmortem: INC-42 - API latency spike

## Summary
Brief description of the incident impact.

## Timeline
| Time (UTC) | Event |
|------------|-------|
| 14:30 | Incident opened |
| 14:35 | Investigator assigned |
| 14:50 | Root cause identified |
| 15:10 | Mitigation applied |
| 15:30 | Incident resolved |

## Root Cause
...

## Action Items
- [ ] Implement rate limiting on API gateway
- [ ] Add CPU alert threshold at 80%
- [ ] Update runbook for database failover

Notion setup

Prerequisites

• A Notion Integration created at notion.so/my-integrations
• The integration connected to a Notion database for postmortems

Configuration

1. In Notion, create a database with columns for incident metadata (Title, Severity, Date, Status).
2. Share the database with your Notion Integration.
3. Go to Settings > Integrations > Notion in the Batida dashboard.
4. Enter the Notion Integration token (starts with ntn_ or secret_).
5. Select the target database from the list of shared databases.
6. Click Save & Verify.

Integration Token: ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
Database ID:       abc123def456...

Generated database entry

Batida creates a new page in the selected database with the following properties:

Notion property	Value
Title	INC-42: API latency spike
Severity	Critical
Date	2026-04-20
Status	Postmortem Complete
Duration	1h 0m
Assignee	Jane Doe

The page content includes the full timeline, root cause analysis, and action items.

Troubleshooting

• "Unauthorized" (Confluence): Verify the API token and email. Ensure the account has permission to create pages under the selected parent page.
• "Could not find database" (Notion): Confirm the Notion Integration has been invited to the database. Open the database in Notion, click Share, and add the integration.
• Pages not created: Check the integration activity log under Settings > Integrations for detailed error messages. Ensure the postmortem trigger is enabled for the incident severity levels you expect.