Only show these results:

In Beta

Microsoft Graph for events in currently in beta. We can't guarantee feature availability or functionality.

Microsoft Graph for Events - Beta

Nylas now offers Microsoft Graph permissions for events only. We recommend using Graph for events if you currently don’t use Nylas for calendar or events. If you currently use calendar, please see our recommendations for existing calendar customers.

New Customers

No changes are needed. You’ll be able to select the Graph scopes when creating your Azure app.

Existing Email and Contact Only Customers

If you want to use Graph, you’ll have to delete then reauthenticate the account with new scopes.

Deleting the account means the previous data is gone. Once the account is authenticated, Nylas will resync the account data. The accounts will not be connected in any way.

Delete the extra account

If you decide not to delete the account and instead reauthenticate the same account with new Graph scopes. You’ll be charged for 2 accounts. The accounts are not connected in any way.

Existing Calendar Accounts

If you don't want to enable Microsoft Graph, no changes are required.

If you want to start using Microsoft Graph follow the instructions below.

  1. You’ll need to authenticate the account as a new account with the calendar-only scope. Nylas will create a new account with a separate account_id.
  2. The account will re-sync calendar data based on your webhook and sync policy.
  3. Delete the previous account, once the new account is authenticated. Otherwise, you will be billed for two accounts.

Delete the extra account

If you decide not to delete the account and instead reauthenticate the same account with new Graph scopes; You’ll be charged for 2 accounts. The accounts are not connected in any way.

Azure Account Scopes

If you want to use Graph, add the new scopes to your Azure app.

  • Calendar.Read.Shared
  • Calendar.ReadWrite.Shared

Your users will need to reauthenticate with the new scopes.

Supported Authentication

We will only support OAuth for Graph scopes.

Hosted Authentication

You will need to create an Azure app and have the client ID and secret linked to Nylas.

Native Authentication

You’ll need to authenticate using the refresh token, Azure client ID, and client secret. When making the authentication request, pass in graph as the provider.


curl -X POST https://api.nylas.com/connect/authorize -d '{
"client_id": "<NYLAS_CLIENT_ID>",
"name": "Nyla the Cheetah",
"email_address": "nyla@nylas.com",
"provider": "graph",
"settings":{
"microsoft_client_id": "<MICROSOFT_CLIENT_ID>",
"microsoft_client_secret": "<MICROSOFT_CLIENT_SECRET?",
"microsoft_refresh_token": "<MICROSOFT_REFRESH_TOKEN>",
"redirect_uri": "https://example.com/redirect", # Redirect URI that the was originally used to get the refresh token
},
"scopes": "calendar"
}'