Connecting your mailbox to Soup Mail: Microsoft 365

This article describes how you can connect your Microsoft 365 mailbox account to Soup Mail, so that Soup Mail syncs folders directly to your mailbox. There are some FAQs at the end of this article about connecting too.

How to connect

  1. Log in to Soup Mail, and navigate to the Settings in the top right of the green banner.
  2. Here, click on "Mailbox" to show the mailbox connection dialog.Screen_Shot_2022-09-05_at_10.42.03_am.png
  3. In the drop-down at the top of the screen, select "Enabled". If you are re-connecting, you may need to first toggle it to "Disabled" and then back to "Enabled".
  4. Click on the "Mailbox connection details" drop-down, which presents options for connection types. Here, select "Office 365".Screen_Shot_2022-09-05_at_10.42.27_am.png
  5. Now click "Connect".
  6. Screen_Shot_2022-09-05_at_10.42.42_am.png
  7. You may see a dialog confirming the connection permissions. Review the details of this dialog, and click "Accept". If you are a Microsoft 365 tenant administrator, you will see a checkbox to "Consent on behalf of your organisation". You may wish to do so, in which case users in your tenant connecting to Soup Mail will not need to provide this consent.Screen_Shot_2022-09-05_at_10.43.02_am.png
  8. You may be prompted for your Microsoft 365 credentials, if you are not already logged into a M365 session in your browser.
  9. You will now see a confirmation at the top of the screen, indicating that you're now connected.Screen_Shot_2022-09-05_at_10.43.33_am.png
  10. Sync will now operate as normal.


  • I didn't see a consent prompt/something popped up but disappeared straight away
    This might happen if your tenant admin has already accepted the consent prompt on behalf of your organisation, and you're already logged in to Microsoft 365 in your browser. There's nothing to worry about.
  • I've done this, but I see a different email address in "CONNECTED TO"
    This happens for users whose teams have previously been connected to Soup Mail using a service account. It is just displaying the service account mailbox, but it does not affect your connection.
  • It says I'm connected, but how do I check it's working?
    You can confirm that sync is working by favouriting a folder in Soup Mail (in the Folders view, click the grey star alongside the reference/name of a folder - it will turn green). Once you do this, a short time later (within half a minute, usually) you should see the folder appear under your "Soup Mail | My-Team-Name" root folder in your Outlook mailbox. You may need to sync Outlook (Send/Receive All, in Outlook) to see the folder if you don't want to wait.
  • What are you talking about? What's sync folders?
    Sync folders is one of the ways to save emails to Soup Mail. It works by connecting our servers to your mailbox, and it creates a folder in your mailbox for each Soup Mail folder you've favourited, so you can drag-and-drop emails within your mailbox to save them to Soup Mail. More info is here.
Have more questions? Submit a request


Article is closed for comments.