Site Mailbox

A site mailbox can be used from a SharePoint team site to store and organize team email. It can also be used from Outlook 2013 for team email, and to quickly store attachments and retrieve documents from the team site. 

You can add one site mailbox per site.


It sometimes does happen that a site mailbox is not created properly and all troubleshooting steps failed. 
One of the symptoms may be this error message appearing for several days:

All you need to do is remove the site mailbox and add again.


In order to thoroughly remove the site mailbox app follow all of the steps below in that order.

From User Interface

1. Try to remove the app from the User Interface.

This may or may not work at this stage. If you receive an error - do not worry.

From Powershell

1. Open Powershell with Azure Active Directory Module installed and connect to Exchange Online.

2. Check if the mailbox has been created using the cmdlet:


Where SITENAME is the title of your SharePoint site. If you receive an error that a mailbox could not be found, do not get discouraged. It could have been malformed with a different name.

3. Verify all your site mailboxes:

 Get-Mailbox -RecipientTypeDetails Teammailbox

If you have a lot of site mailboxes, you can try sorting by date created (so that the recent ones are at the bottom):

Get-Mailbox -RecipientTypeDetails Teammailbox | sort whenmailboxcreated

The corrupt name may look like SMO-RN70789.

4. Remove the mailbox using
Remove-Mailbox SMO-RN70789
Remove-Mailbox SMO-SITENAME

and verify if it is gone from the list of all mailboxes:

Get-Mailbox -RecipientTypeDetails Teammailbox

5. This, however, may not do the job.  Check if you still have a user of the same name, using:

Get-MsolUser | where {$_.CloudExchangeRecipientDisplayType -eq 16}

6. If the user is on the list remove him and then remove that deleted user from the recycle bin.

Remove-MsolUser -User
Get-Msoluser -returndeletedusers
Remove-Msoluser -Userprincipalname -removeFromRecycleBin

7. Verify if the user is gone from the list:

Get-MsolUser | where {$_.CloudExchangeRecipientDisplayType -eq 16}

From SharePoint Designer

1. Download and install SharePoint Designer.

2. Open your website in SharePoint Designer.

3. Click on Site Options>a dialog box should appear.

4. Choose 4 features related to Exchange Mailbox: 
  • ExchangeTeamMailboxEmailAddress
  • ExchangeTeamMailboxSiteCollectionUrl
  • ExchangeTeamMailboxSiteID
  • ExchangeTeamMailboxSharePointUrl) 
and remove them.


The steps are also available using CSOM and Powershell

From User Interface (again)

Go back to your site and remove the app from the User Interface. If it didn't work before, it should work now. In the unlikely event that it should still pose some problems, please paste the error message in the comments and start a question thread on the Sharepoint MSDN forum.

Create a new site mailbox

Now that your site mailbox is safely removed, you may want to add a new one.

You can do it from the User Interface or from Powershell:

New-SiteMailbox -DisplayName MySiteMailbox -SharePointUrl


When creating a site mailbox you may encounter the following errors:
  • Unauthorized

Solution: Verify the site URL.

  • Windows Live ID already exists

That means that the mailbox has already been created in some way, e.g. when I misspelled the SharePoint URL.
Solution: Find the user and remove him.

get-msoluser -user
remove-msoluser -user
remove-msoluser -user -RemoveFromRecycleBin

  • Site Mailbox app hasn't been installed

Solution: Verify if the site mailbox feature is activated under Site Settings>>Site Features>>Site Mailbox>>Activate


 Scripts for creating site mailboxes via Powershell:

Other Languages

This article is available also in other languages:

Wiki: SharePoint Online: Jak usunąć skrzynkę witryny oraz często występujące błędy przy tworzeniu nowej skrzynki (pl-PL)