Troubleshooting Microsoft configuration

This page describes common issues you might encounter when using Microsoft accounts with Nylas and how to troubleshoot them.

Gather Exchange logs

Sometimes, Nylas can’t sync because of internal errors on the Exchange server. Because we can’t access any logging information, it can be difficult to determine why the Exchange server is experiencing these errors.

If you need help troubleshooting your Exchange server and you have a contract with us, you can share more detailed error information from the Exchange server with us.

1. Log in to Outlook on the web.
2. On the menu bar, click the Settings symbol.
3. Select General > Mobile devices in the left navigation.
4. Find the mobile device that you want to enable logging for an click the pencil symbol to view its details.
5. Review the device’s details and confirm that the User agent is python-EAS-client 1.0. This is the name that Nylas uses to connect to your application.
6. Click the Enable logging symbol, and click Save.
7. Reproduce the issue you experienced. If you have a general sync issue, try sending a test message and let the logger gather data for about 10 minutes.
8. Check your inbox for a message titled “Exchange ActiveSync Mailbox Logs”.
9. Download the message and include it as an attachment when you reach out for support.

For more information on mobile device options in Outlook, see Microsoft’s official documentation.

Invite Nylas to your Azure app

If you need help troubleshooting your Microsoft OAuth settings and you have a contract with us, you can give the Nylas Support team permissions to access your Azure auth app. This lets the team review your app’s settings, give feedback on potential authentication issues, and suggest next steps.

Invite Nylas Support to your Azure app

1. Log in to the Microsoft Azure Portal as an administrator.
2. Search for Microsoft Entra ID and navigate to the resulting page.
3. Select Manage > Users in the left navigation.
4. Click New user, then Invite external user.
5. Add [email protected] and click Review + invite.

Grant admin permissions to Nylas Support

After you invite the Nylas Support team to your Azure auth app, you can give them administrator permissions. This lets the team access your app’s settings for troubleshooting purposes.

1. From the Azure Portal home page, search for Microsoft Entra ID and navigate to the resulting page.
2. Click Manage > Roles and administrators.
3. Select Application administrator from the list of roles.
4. Click Add assignments.
5. Search for [email protected] and click Add.