Skip to main content
The Microsoft connector supports all products which are a part of the Microsoft Graph API. These include:
  • OneDrive
  • SharePoint
  • Outlook
  • OneNote
  • Teams
For a full list of supported products, refer to Microsoft documentation. We also have connectors for:

​
What’s Supported

​
Supported Actions

This connector supports:

​
Before You Get Started

To connect Microsoft services with Ampersand, you will need a Microsoft Account. Once your account is created, you’ll need to create an app in the Azure portal, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:
  • Client ID
  • Client Secret
  • Scopes
You will then use these credentials to connect your application to Ampersand.

​
Create a Microsoft Account

Here’s how you can sign up for a Microsoft account:

​
Creating a Microsoft App

Follow the steps below to create a Microsoft app and add the Ampersand redirect URL.
  1. Log in to your Azure Portal.
  2. Navigate to Azure Active Directory > App registrations.
  3. Click the New registration button.
  4. In the Register an application window, enter the Name and select the Supported account types.
  5. In the Redirect URI section, select Web and enter the Ampersand redirect URL: https://api.withampersand.com/callbacks/v1/oauth.
  6. Click Register.
  7. In the left-hand sidebar, navigate to Certificates & secrets.
  8. Click New client secret and provide a description and expiration period.
  9. Click Add. Note the Client Secret value. You will need it later.
  10. In the left-hand sidebar, navigate to Manage >> API permissions.
  11. Click Add a permission and choose the required scopes. You must include the offline_access scope.
  12. Generate Microsoft App Creation

​
Add Your Microsoft App Info to Ampersand

  1. Log in to your Ampersand Dashboard.
  2. Select the project where you want to create a Microsoft integration. Ampersand Project Selection
  3. Select Provider Apps.
  4. Select Microsoft from the Provider list.
  5. Enter the previously generated Client Secret in the Client Secret field.
  6. For the Client ID field, go to the Overview page in your Microsoft application, and copy the Application ID.
  7. Enter the exact set of scopes that you had previously configured in your Microsoft app.
  8. Click Save Changes.
In order to receive a refresh token and be able to access your customers’ Microsoft Graph APIs without reauthenticating, you must include the offline_access permission when registering the app with Ampersand