> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SharePoint

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 future.

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

<img src="https://mintcdn.com/incidentio-18bb4170/LM9h1Va3CXZhCFQH/images/help-centre/api-and-integrations/collaboration/sharepoint/intro-overview.png?fit=max&auto=format&n=LM9h1Va3CXZhCFQH&q=85&s=55bc9a808eb7d33568931be88f9daba9" alt="SharePoint integration overview" width="2084" height="1520" data-path="images/help-centre/api-and-integrations/collaboration/sharepoint/intro-overview.png" />

***

<Warning>
  It's important to know that when the integration is installed, the connection to incident.io will belong to **the user
  that installed it**. SharePoint 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. We use the same user account connection for all our
  Microsoft integrations. Therefore, the account you use to connect this integration will need to be the same for
  Microsoft Teams and Outlook.
</Warning>

## 1. Installing the Integration

Go to [Settings → Integrations](https://app.incident.io/~/settings/integrations), find "SharePoint".

Click "Install" and you'll be redirected to the Microsoft installation flow. Review the permissions we're requesting and click "Accept":

<img src="https://mintcdn.com/incidentio-18bb4170/LM9h1Va3CXZhCFQH/images/help-centre/api-and-integrations/collaboration/sharepoint/sharepoint-integration-permissions.png?fit=max&auto=format&n=LM9h1Va3CXZhCFQH&q=85&s=5c4fb6d21244f5eee39b94e175947ab1" alt="SharePoint integration permissions" width="900" height="1078" data-path="images/help-centre/api-and-integrations/collaboration/sharepoint/sharepoint-integration-permissions.png" />

Once you've completed the Microsoft authentication flow, you'll be redirected back to incident.io:

<img src="https://mintcdn.com/incidentio-18bb4170/TO27aGh8ReZgi7PY/images/help-centre/api-and-integrations/collaboration/sharepoint/integration-overview.png?fit=max&auto=format&n=TO27aGh8ReZgi7PY&q=85&s=cc183e2314ba17f08b5fc21f707c93b0" alt="Integration overview" width="1362" height="1478" data-path="images/help-centre/api-and-integrations/collaboration/sharepoint/integration-overview.png" />

## 2. Setting up a post-mortem destination

incident.io has now been connected to SharePoint. Next, we need to specify where in your SharePoint you'd like to export post-mortems to.

Go to [Settings → Post-mortems](https://app.incident.io/~/settings/post-mortem), then click "Add destination"

<img src="https://mintcdn.com/incidentio-18bb4170/aih-bzVNJc6xN5Zn/images/help-centre/api-and-integrations/collaboration/sharepoint/postmortem-settings.png?fit=max&auto=format&n=aih-bzVNJc6xN5Zn&q=85&s=2021c81b8abbaaad2c6a44d228722445" alt="Post-mortem settings" width="942" height="776" data-path="images/help-centre/api-and-integrations/collaboration/sharepoint/postmortem-settings.png" />

Within your web browser, navigate to the folder in SharePoint where you'd like to export post-mortems to.

<img src="https://mintcdn.com/incidentio-18bb4170/aih-bzVNJc6xN5Zn/images/help-centre/api-and-integrations/collaboration/sharepoint/navigate-sharepoint-folder.png?fit=max&auto=format&n=aih-bzVNJc6xN5Zn&q=85&s=34bdbb809f230491264d76cc71cc0ea5" alt="Navigate SharePoint folder" width="1576" height="456" data-path="images/help-centre/api-and-integrations/collaboration/sharepoint/navigate-sharepoint-folder.png" />

Click the share button

<img src="https://mintcdn.com/incidentio-18bb4170/aih-bzVNJc6xN5Zn/images/help-centre/api-and-integrations/collaboration/sharepoint/share-button.png?fit=max&auto=format&n=aih-bzVNJc6xN5Zn&q=85&s=c1a0d2adcd5a0dbddc851baf4d002bf2" alt="Share button" width="968" height="656" data-path="images/help-centre/api-and-integrations/collaboration/sharepoint/share-button.png" />

Click "Copy link".

<img src="https://mintcdn.com/incidentio-18bb4170/aih-bzVNJc6xN5Zn/images/help-centre/api-and-integrations/collaboration/sharepoint/copy-link.png?fit=max&auto=format&n=aih-bzVNJc6xN5Zn&q=85&s=d4d9dafd14fe9c16da9a4f8f552aff41" alt="Copy link" width="926" height="788" data-path="images/help-centre/api-and-integrations/collaboration/sharepoint/copy-link.png" />

Paste the link in, give it a sensible name, and click "Create".

You should now be good to go!

## Permissions

* `Sites.ReadWrite.All` - Enables us to read the site/document library/folder structure so users can pick a target location for exports, and to write post-mortem documents to the selected SharePoint location.
