What you get
- Export follow-ups into a Notion database as new pages
- Connect an existing Notion page by pasting its URL
- Sync title, description, status, assignee, and priority back from Notion
- Export templates and auto-export rules, with the database as the project equivalent
Set up
- Install the Notion integration if you have not already.
- Open Settings → Integrations → Notion and turn on Use as issue tracker.
- In Notion, share the task database (and its teamspace if needed) with the incident.io connection. See Grant access to specific pages.
- Confirm the database has a Status property. Databases without one cannot be used for follow-up export.
Database conventions
As a Notion database is completely free-form, we have a few built-in conventions to enable follow-ups to sync back into incident.io from Notion.Required: Status
The database must include a Status property. We use the first Status column from left to right, and rely on that to drive the status in incident.io. Follow-up status comes from the Notion status group the option sits in, not from the option’s display name:
Exception: Complete options named
cancelled, declined, or not doing (case-insensitive) sync as not doing.
Optional: Assignee or Owner
A People property named Assignee or Owner (case-insensitive) syncs the follow-up owner. If the database has no such column, we leave the follow-up assignee unchanged.Optional: Priority or Urgency
A Select column named Priority or Urgency (case-insensitive; Priority wins if both exist) can be filled on export from the follow-up’s priority. We write the priority option name into Notion. Priority changes in Notion sync back to incident.io, as long as the option names match your follow-up priorities.Title and description
- Title is required when creating a page.
- A Description rich-text property exports and syncs both ways when present.
Other properties
Once you pick a database, the export form and templates list the writable properties in database order. You can map strings, numbers, checkboxes, URLs, emails, phones, dates, selects, multi-selects, status options, and people. Unwritable property types are skipped.Export a follow-up
- Open the follow-ups page, or an incident’s follow-ups.
- Choose Export (or create a new ticket) and select Notion.
- Pick the database, then fill any fields your template or form requires.
- Confirm. We create a page in that database and link it to the follow-up.
Connect an existing Notion page
Paste a Notion page URL into the incident channel, or use Connect to existing on the follow-up. Deep links with query strings or#fragments work. The page must be one the integration can access.
What syncs
FAQs
Why can't I select my Notion database?
Why can't I select my Notion database?
It needs a Status property, and the incident.io connection must have access to that database (and its teamspace). Share it under Notion Settings → Connections, or reconnect the integration and select the right pages.
Why isn't status updating in incident.io?
Why isn't status updating in incident.io?
Notion has no page webhooks. Open the follow-ups page to trigger a sync, or wait for the daily catch-up. Confirm the page’s status sits in the Complete group if you expect the follow-up to complete.
Can I use the same Notion install for post-mortems and follow-ups?
Can I use the same Notion install for post-mortems and follow-ups?
Yes. Post-mortem export and follow-up export share the Notion connection. Turn on Use as issue tracker only when you want follow-up export offered in the product.