Getting access to the Outlook Categories

Question and Answers
1

Hello,
I want to use Nylas to read, edit and delete the categories on Outlook.

From the documentation I understand that I cannot do it with the basic settings.

MS Graph API documentation says that we need access to MailboxSettings.ReadWrite setting. This setting is missing from the Nylas Outlook Setup page. Is there a way I can enable this permission and then edit the labels via the SDK?

Or maybe there is a totally different way of doing this?

Thank you in advance!

2

Nylas does not have any direct tool to work with the Folders Categories (also called Labels), when you’re working with Outlook categories/labels in Nylas API v3, you can use the Folders API endpoints to check labels and folders. The Nylas API uses the same commands to manage both folders and labels, and can refer to specific folders using the provider’s folder_id.

Remember, for Microsoft scopes the Folders endpoints require the following permissions:

  • GET /folders and GET /folders/<FOLDER_ID> require Mail.Read (minimum), Mail.ReadWrite, Mail.ReadWrite.Shared, or Mail.Read.Shared
  • POST /folders, PUT /folders/<FOLDER_ID>, and DELETE /folders/<FOLDER_ID> require Mail.ReadWrite or Mail.ReadWrite.Shared

You can overwrite the default scopes associated with a connector on a per-request basis by making a GET /v3/connect/auth request and including the scope string. This allows you to request additional Microsoft Graph scopes beyond the default ones configured in your connector.The available Folders operations include:

  • GET /v3/grants/{grant_id}/folders
  • POST /v3/grants/{grant_id}/folders
  • GET /v3/grants/{grant_id}/folders/{folder_id}
  • PUT /v3/grants/{grant_id}/folders/{folder_id}
  • DELETE /v3/grants/{grant_id}/folders/{folder_id}

You can also subscribe to folder notifications for folder.created, folder.updated, and folder.deleted events.

3

Thank you for your reply but I still do not think this solves the problem of editing email categories on Outlook. This is because folders and categories are different entities in MS Graph API.

Do you think I can still use Nylas to edit the category (not the label or the folder)

4

I apologize for the confusion here. “Categories” mean different things to different email providers so we have had some mix-ups in our responses.

We don’t have the ability to create, edit, or delete categories in Outlook via the Nylas API.

This is a great feature request though and I have passed this along to our Product team to see if this is something we can add as a future feature.