# Getting access to the Outlook Categories **URL:** \ **Category:** Question and Answers\ **Tags:** email-api\ **Created:** [July 15, 2025, 4:40pm UTC](https://forums.nylas.com/t/getting-access-to-the-outlook-categories/795 "2025-07-15T16:40:03Z")\ **Posts on this page:** 5\ **Page:** 1
**Author:** ![rjtmehta](https://avatars.discourse-cdn.com/v4/letter/r/ea666f/32.png) [@rjtmehta](https://forums.nylas.com/u/rjtmehta)\ **Post date:** [July 15, 2025, 4:40pm UTC](https://forums.nylas.com/t/getting-access-to-the-outlook-categories/795/1 "2025-07-15T16:40:03Z")
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! ---
**Author:** ![sam](https://sea1.discourse-cdn.com/flex015/user_avatar/forums.nylas.com/sam/32/287_2.png) [@sam](https://forums.nylas.com/u/sam)\ **Post date:** [July 15, 2025, 6:02pm UTC](https://forums.nylas.com/t/getting-access-to-the-outlook-categories/795/2 "2025-07-15T18:02:24Z")
> [@rjtmehta](#): > > 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? 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/` require `Mail.Read` (minimum), `Mail.ReadWrite`, `Mail.ReadWrite.Shared`, or `Mail.Read.Shared` - **POST** `/folders`, **PUT** `/folders/`, and **DELETE** `/folders/` 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. ---
**Author:** ![rjtmehta](https://avatars.discourse-cdn.com/v4/letter/r/ea666f/32.png) [@rjtmehta](https://forums.nylas.com/u/rjtmehta)\ **Post date:** [July 16, 2025, 12:27pm UTC](https://forums.nylas.com/t/getting-access-to-the-outlook-categories/795/3 "2025-07-16T12:27:50Z")
> [@sam](#): > > 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/` require `Mail.Read` (minimum), `Mail.ReadWrite`, `Mail.ReadWrite.Shared`, or `Mail.Read.Shared` > - **POST** `/folders`, **PUT** `/folders/`, and **DELETE** `/folders/` 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. 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](https://learn.microsoft.com/en-us/graph/api/resources/outlookcategory?view=graph-rest-1.0) (not the label or the folder) ---
**Author:** ![alex-nylas](https://avatars.discourse-cdn.com/v4/letter/a/22d042/32.png) [@alex-nylas](https://forums.nylas.com/u/alex-nylas)\ **Post date:** [July 17, 2025, 3:24pm UTC](https://forums.nylas.com/t/getting-access-to-the-outlook-categories/795/4 "2025-07-17T15:24:15Z")
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. ---
**Author:** ![sergio.nalin](https://avatars.discourse-cdn.com/v4/letter/s/5f8ce5/32.png) [@sergio.nalin](https://forums.nylas.com/u/sergio.nalin)\ **Post date:** [September 15, 2026, 4:06pm UTC](https://forums.nylas.com/t/getting-access-to-the-outlook-categories/795/5 "2026-09-15T16:06:53Z")
Hello, has this feature been implemented? It would be quite handy. The documentation is not mentioning it but maybe it’s not updated…