Version:
Only show these results:

Use Microsoft accounts and data with Nylas

The Nylas platform drastically reduces the effort it takes to use Microsoft accounts with your application. With just a few lines of code, you can add full email, calendar, and contacts features to your project.

This page introduces you to Microsoft provider auth apps.

Supported Microsoft providers

Nylas supports the following Microsoft providers:

🔍 The Nylas Calendar API does not currently support Microsoft Shared Calendars.

Bulk authentication grants

You can use Microsoft bulk authentication grants to make and authorize requests to the Nylas APIs for applications or cloud provider compute workloads. Keep the following things in mind when working with bulk auth grants:

Distribution lists

Nylas allows you to send email messages to or from distribution lists and groups by adding them to messages as a participant. For example, if you want to send an email message to the nylas-test@example.com distribution list, you can add it to the to, cc, or bcc fields in your Send Message request. To send email messages from a distribution list, set its email address in the from and reply_to fields.

⚠️ Nylas does not create grants for Microsoft distribution lists or groups. They can only be included on email messages as participants.

Microsoft national clouds

Nylas currently does not support accounts provisioned on national cloud environments (for example, accounts for the U.S. government, China, or Germany). These environments use different Microsoft Entra ID (formerly "Azure Active Directory") endpoint URLs for the authentication process.

Nylas supports accounts authenticated using the following Microsoft Entra ID (global services) endpoint URLs only:

  • microsoftonline​.com
  • office365.com

Microsoft provider limitations

Keep the following limitations in mind when you work with Microsoft accounts:

  • Microsoft Graph has a set of service-specific throttling limits, and an overall rate limit of 130,000 requests every 10 seconds. For more information, see the official Microsoft documentation.
  • You can only use Microsoft's modern authentication/OAuth to authenticate Microsoft 365 accounts. For authentication instructions, see Authenticate Microsoft accounts with Nylas.
  • You can't authenticate Microsoft account aliases, shared mailboxes, distribution groups, or Microsoft 365 group lists to Nylas. You can authenticate individual mailboxes only.
  • As of October 1, 2022, Microsoft has deprecated Basic authentication for all Exchange Online accounts.
  • Nylas can't sync email accounts that are in admin groups.
  • Nylas v3 no longer supports Exchange on-premises service accounts.

You can also review Nylas' Microsoft authentication guide for information on authenticating Microsoft users with your Nylas application. For a list of EWS-specific limitations, see Nylas' Authenticate with Exchange on-prem guide.