Notion

Connecting Notion for exporting post-mortems

incident.io Engineering Team avatar
Written by incident.io Engineering Team
Updated over a week ago

After your incident is over, it can be useful to dig into what happened in an incident, why, and how it can be prevented in the future.

Our Notion Integration allows you to export post-mortems into Notion. Which you can then use to collaborate with your team.


πŸ”¨ Installation

Go to Settings β†’ Integrations, find "Notion" and click "Install".

It's important to know that when the integration is installed, the connection to incident.io will belong to the user who installed it. Notion connections like this, which use OAuth, belong to a specific user β€” for this reason, you may wish to set up a dedicated service or "bot" account.

Click "Install in Notion", and you'll be redirected to the install flow within Notion. Review the permissions we're requesting, and click "Next"

We also need to install a template for the pages we create. Click "Use a template provided by the developer", and then "Allow access"

You're done

Congratulations, it's been installed πŸŽ‰

You'll find the page in your private Notion space – move it to somewhere that suits you, and that can be accessed by everyone.


πŸ“„ Exporting your first post-mortem

1️⃣ Go to the incident timeline of an incident

2️⃣ On the right-hand side, in the "Post-mortem" section, click "Create a post-mortem"

3️⃣ The 'Create post-mortem modal" will appear

  • Select "Notion" from the destinations

  • Select your template

  • Select which timezone should be used

  • Click "Create" and wait a few seconds

  • Your post-mortem document has been created, and it'll be linked to the incident page

Did this answer your question?