Add-MailboxFolderPermission: Calendar Examples, Roles and Set

4 min read James Futhey Updated November 13, 2026
Windows PowerShell ISE editing a script with the command output shown in the console below

Quick answer: To give someone access to one folder in a mailbox, run Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor. The folder goes after :\. Add creates a new entry; if the user already has one on that folder, change it with Set-MailboxFolderPermission instead.

What do Add- and Set-MailboxFolderPermission do?

They grant folder-level permissions, for example on the Calendar, Inbox or a custom folder, rather than the whole mailbox.

  • Add-MailboxFolderPermission adds a new permission entry for a user.
  • Set-MailboxFolderPermission modifies an existing entry. The rights you give replace the user's current rights on that folder.
  • Remove-MailboxFolderPermission removes all of a user's permissions on the folder. See Remove-MailboxFolderPermission.

All three work in Exchange Server 2010 through Exchange Server SE and in Exchange Online. You need to be assigned permissions before you can run them. For access to the whole mailbox, use Add-MailboxPermission.

How do I connect first?

Exchange Online:

Install-Module -Name ExchangeOnlineManagement
Connect-ExchangeOnline -UserPrincipalName admin@contoso.com

See how to install the Exchange Online PowerShell module.

On-premises Exchange: open the Exchange Management Shell and run the same commands.

Examples

Task Command
Edit access to a calendar Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor
Read-only calendar access Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Reviewer
Free/busy plus subject and location Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights LimitedDetails
Read the Inbox Add-MailboxFolderPermission -Identity ayla@contoso.com:\Inbox -User ed@contoso.com -AccessRights Reviewer
Owner of a custom folder Add-MailboxFolderPermission -Identity ayla@contoso.com:\Marketing -User ed@contoso.com -AccessRights Owner
Calendar delegate (Exchange Online) Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User julia@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate
Delegate who sees private items Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User laura@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate,CanViewPrivateItems
Send a sharing invitation too Add -SendNotificationToUser $true (Exchange Online, calendar only)
Change existing access Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Reviewer

The Identity format is Mailbox:\Folder\Subfolder, for example john@contoso.com:\Calendar or John:\Inbox\Reports.

What are the AccessRights roles?

Role Permissions it includes
Owner Create, read, edit and delete all items; create subfolders; FolderOwner and FolderContact
PublishingEditor Create, read, edit and delete all items; create subfolders
Editor Create, read, edit and delete all items
PublishingAuthor Create and read items; edit and delete own items; create subfolders
Author Create and read items; edit and delete own items
NonEditingAuthor Create and read items; delete own items
Reviewer Read items
Contributor Create items and see the folder
AvailabilityOnly Calendars only: free/busy
LimitedDetails Calendars only: free/busy with subject and location
None No access

You can also give individual permissions instead of a role: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderContact, FolderOwner, FolderVisible and ReadItems. Separate several with commas.

How do calendar delegates work?

In Exchange Online, -SharingPermissionFlags makes someone a delegate. It only works on calendar folders with -AccessRights Editor.

  • Delegate: the user receives meeting invites and responses for the mailbox.
  • Delegate,CanViewPrivateItems: the same, plus private items. CanViewPrivateItems needs Delegate.
  • None: no delegate access.

Editor without the Delegate flag still lets the user accept or decline a meeting by opening the request in the mailbox. See also adding delegates to resource mailboxes.

Watch out when changing a delegate with Set

With Set-MailboxFolderPermission, leaving out both -SendNotificationToUser and -SharingPermissionFlags keeps the user's delegate status. Using -SendNotificationToUser alone resets SharingPermissionFlags to None, which removes delegate access. To keep a delegate, pass -SharingPermissionFlags Delegate explicitly.

Who can be granted folder permissions?

-User accepts user mailboxes, mail users and mail-enabled security groups, including nested ones. Microsoft recommends a UPN (user@contoso.com) or domain\SamAccountName.

How do I check folder permissions?

Get-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar

This lists every entry on the folder with its AccessRights. In Exchange Online, Get-EXOMailboxFolderPermission does the same.

Troubleshooting

Problem Fix
PowerShell says the cmdlet isn't recognized Connect first: Connect-ExchangeOnline, or open the Exchange Management Shell.
Add fails because the user already has an entry Use Set-MailboxFolderPermission to change it.
The folder can't be found Check the Mailbox:\Folder format and the folder's name in that mailbox.
-SharingPermissionFlags is rejected It needs Exchange Online, a calendar folder and -AccessRights Editor.
-SendNotificationToUser is rejected It needs Exchange Online, a calendar folder, and AvailabilityOnly, LimitedDetails, Reviewer or Editor.
A delegate stopped getting meeting requests after a Set -SendNotificationToUser reset the flags. Run Set again with -SharingPermissionFlags Delegate.
A group was granted access but members can't see the folder Use a mail-enabled security group.

Summary

  • Use Mailbox:\Folder as the Identity.
  • Add creates an entry; Set replaces an existing one; Remove deletes it.
  • Reviewer reads, Editor edits, Owner controls the folder. AvailabilityOnly and LimitedDetails are for calendars.
  • In Exchange Online, -SharingPermissionFlags Delegate with Editor makes a calendar delegate.
  • Check the result with Get-MailboxFolderPermission.

Related: Remove-MailboxFolderPermission, Add-MailboxPermission, Get-MailboxPermission, resource mailbox delegates.

Meeting Room 365 turns any iPad or Android tablet into a room display for Exchange and Microsoft 365 calendars. See the features or pricing: $9 a display a month.

Add a display to your office

Every room, on the door.

Live availability on every meeting room. Works with Microsoft 365, Exchange and Google Workspace.