Only show these results:

Azure App

To integrate with Microsoft Teams, you need an Azure app.

Existing Azure App

If you already have an Azure app, follow all of the steps listed.

New Azure App

If you want to create a new Azure app or don't currently have one, follow our guide on creating an Azure app and return to this page once you're done to follow the rest of the steps.

Upgrade to Graph

The steps below cover the process of upgrading to Graph.

Step 1: Add Relevant Graph Scopes

The relevant Graph scopes in the Azure app are required for your Nylas integration. Before continuing to Step 2, confirm all permissions by following the steps below:

  1. From the Azure portal home page, click Azure Active Directory.
  2. Click App Registrations.
  3. Click on the application you want to configure.
  4. On the left, click API Permissions.
  5. Click Add a permission.
  6. Click Microsoft Graph.
  7. Depending on the Nylas features you are using, add the permissions below:
    • Email Messages Read only | Mail.Read
    • Email Messages Read and Write | Mail.ReadWrite
    • Email Send | Mail.Send
    • Calendar Read and Write | Calendar.ReadWrite
    • Contacts Read only | Contacts.Read
    • Contacts Read and Write | Contacts.ReadWrite

Keep the existing EWS and EAS scopes

We will move services over in phases. Your integration may experience interruptions if you remove Exchange Web Service (EWS) or Exchange ActiveSync (EAS) scopes. We will update you on when you can remove scopes.

In the Azure App Manage section, the API permissions tab shows configured permissions for Microsoft Graph.

Step 2: Re-authenticate Users

You'll need to re-authenticate your users to add the additional Graph scopes for Nylas. This switches to using Graph for your integration. Re-authentication is required for the changes to take effect. To complete this, you'll need to do one of the following:

  • Force re-authentication for your users.
  • Communicate the changes to your users for them to re-authenticate.

Step 1: Add Graph Permissions for Microsoft Teams

You'll need to add the Graph permission OnlineMeetings.ReadWrite and Mail.Read to your Azure app. Adding permissions to an existing app will require users to re-authenticate.

  1. From within your app in the Azure portal, click on API permissions.
  2. Click on Add a permission.
  3. Click Microsoft Graph.
  4. Click Delegated permissions.
  5. Use the search bar to find OnlineMeetings.ReadWrite and Mail.Read.

Step 2: Add Redirect URIs

  1. From within your app in the Azure portal, click Authentication.
  2. Click Add a platform.
  3. Click Web.
  4. The URI is required to complete the authentication flow. The URI you'll add depends on your location:
    • If you're in the United States, use https://beta.us.nylas.com/connect/callback
    • If you're in Europe, use https://beta.eu.nylas.com/connect/callback
  5. Click Configure.
  6. Scroll down to the Implicit grant and hybrid flows heading and check both boxes:
    • Access tokens (used for implicit flows)
    • ID tokens (used for implicit and hybrid flows)
  7. Click Save.
  8. Scroll down to the Supported account types heading.
    • Single tenant - You'll need your tenant ID from the Overview page and your app should be MDM verified. It'll work without verification during testing but should be completed before publishing.
    • Multitenant - Nothing for now.
  9. Click Save.

Step 3: Client Secret and Value

If you already have your client secret and value, then you can skip this section.

  1. From within your app in the Azure portal, click Certificates & secrets.
  2. Click New client secret.
  3. Fill in the description field and select the duration you'd like it to be valid.
  4. Copy the value and keep it somewhere safe. You'll need it while creating a Microsoft Teams integration.

What's Next?