Skip to main content
Sometimes, you need to schedule meetings related to your incident. Perhaps a war room for everyone to sync their findings whilst an incident is ongoing, or a debrief about what happened once the incident is resolved. Our Outlook integration lets you attach events to an incident, and pulls through relevant information about when it is and who is attending.

​
Installation

It’s important to know that when the integration is installed, the connection to incident.io will belong to the user that installed it. Outlook connections like this, which use OAuth, belong to a specific user. For this reason, you must set up a dedicated service or “bot” account.
Go to Settings → Integrations, find Outlook Calendar and click Install. Click Install and you’ll be redirected to the Microsoft installation flow. Review the permissions we’re requesting and click Accept: Microsoft Permissions requested page for incident.io, with Consent on behalf of your organisation ticked Once you’ve completed the Microsoft authentication flow, you’ll be redirected back to incident.io: The Outlook Calendar integration page showing the connected user and a Disconnect button

​
Scheduling a debrief

In one-click, we can build an Outlook event which has been pre-filled with the incident participants and other useful information - you just need to fill in the rest. Once your incident has been resolved, a Debrief row appears under Links on its Post-incident tab, with a Schedule action: A Debrief row under Links with a Schedule action next to it This will take you to a pre-populated Outlook event. You just need to choose a time and hit save: A pre-filled Outlook event titled Incident debrief for #INC-166: honey-seahorse, waiting for a time

​
Linking an event from Outlook to an incident

In addition to scheduling a debrief for you, we can also link events created in Outlook to your incidents. You just need to create an event in Outlook which:
  1. Has the incident identifier (e.g. INC-123) in the title or description
  2. Invites the connected user
When this happens, we’ll automatically attach the event to your incident and message the relevant incident channel: A Slack message asking whether the attached Outlook Calendar event is a debrief If you identify the incident as a debrief meeting (i.e. a catch-up after the incident has been resolved), we’ll additionally let the channel know when it’s happening and who’s invited: A Debrief scheduled message in Slack with the title, time, organizer and required invitees Note that if you include the word “debrief” in the event (or whatever your preferred name for this term is, according to your debrief settings ), we’ll automatically attach the event as a debrief without prompting you first.

​
Removing a linked event

If we automatically attach a debrief which should not be linked to your incident, you can unlink it by heading to the sidebar on the incident details page, clicking the debrief, and then clicking … > Unlink debrief: The Debriefs drawer with the row menu open on Unlink debrief