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:

​
Supported Objects

The Microsoft Graph connector supports many Microsoft Graph API objects including but not limited to: For the complete list of supported Graph API resources, refer to the Microsoft Graph API documentation. To figure the exact OAuth scope you will require based on the objects you need to integrate with, you can use a tool such as Graph Permissions Explorer.

​
Example Integration

For an example manifest file of a Microsoft integration, visit our samples repo on Github.

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

​
Using the connector

To start integrating with Microsoft:
  • Create a manifest file like the example.
  • Deploy it using the amp CLI.
  • If you are using Read Actions, create a destination.
  • Embed the InstallIntegration UI component.
  • Start using the connector!
    • If your integration has Read Actions, you’ll start getting webhook messages.
    • If your integration has Write Actions, you can start making API calls to our Write API.
    • If your integration has Proxy Actions, you can start making Proxy API calls.
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