Update Mail Folder

Update mail folder properties via the Microsoft Outlook Mail API PATCH endpoint.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/naftiko/microsoft-outlook-sandbox --skill update-mail-folder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Update Mail Folder
Source: https://github.com/naftiko/microsoft-outlook-sandbox/tree/main/skills/update-mail-folder
Command: npx skills add https://github.com/naftiko/microsoft-outlook-sandbox --skill update-mail-folder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows you to easily rename and modify properties of your existing mail folders, helping you organize your inbox more effectively.

Core Features & Use Cases

  • Rename Folders: Change the display name of any mail folder.
  • Update Properties: Modify other writable properties of a mail folder as needed.
  • Use Case: You can rename a folder from "Old Project" to "Completed Project - Q4 2023" to keep your inbox tidy and reflect current project statuses.

Quick Start

Use the Update Mail Folder skill to rename the mail folder with ID 'AAMkAGI1AAAEJAAA=' to 'Archived Items'.

Frequently Asked Questions about Update Mail Folder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rename an existing mail folder in Microsoft Outlook?

You can update mail folder properties by sending a PATCH request to the Microsoft Outlook Mail API endpoint `/me/mailFolders/{mailFolder-id}`, which allows you to modify the display name and other writable attributes.

Can I update properties other than the display name for an Outlook mail folder?

Yes, you can update other writable properties of an Outlook mail folder by targeting the `/me/mailFolders/{mailFolder-id}` endpoint with the PATCH method, modifying attributes beyond just the folder name.

What is the Microsoft Outlook Mail API endpoint for modifying mail folder properties?

To modify mail folder properties via the Microsoft Outlook Mail API, you send a PATCH request to the `/me/mailFolders/{mailFolder-id}` endpoint, allowing you to change the folder name and other properties.

Do I need the folder ID to rename a mail folder in Outlook?

Yes, you need the specific mail folder ID, such as 'AAMkAGI1AAAEJAAA=', to target the correct `/me/mailFolders/{mailFolder-id}` endpoint when renaming or updating properties in Microsoft Outlook.

What is the best way to keep my Outlook inbox organized by renaming folders?

The best way to keep your Outlook inbox organized is to rename mail folders to reflect current statuses, such as changing an old project folder name to a completed project name using the mail folder update API.