> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replyful.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Microsoft 365

> Bring a Microsoft 365 support mailbox into Replyful. Connect a shared mailbox directly so replies go out from your own address, or forward its mail to Replyful from the Exchange admin center. Covers the permissions each method needs and when forwarding is the better fit.

There are two ways to bring a Microsoft 365 support mailbox into Replyful.

| | Connect the mailbox | Forward the mail |
| - | - | - |
| How it works | Replyful signs in to a shared mailbox and reads and sends through it | Exchange forwards a copy of each email to a Replyful address |
| Replies are sent from | Your own address, like `support@acme.com` | A Replyful address, unless you add a custom domain |
| Replies written in Outlook | Show up on the ticket | Don't show up in Replyful |
| Try it before switching | Yes, Replyful watches the mailbox until you go live | No, it's live straight away |
| Microsoft 365 admin needed | To grant mailbox access, and sometimes to approve Replyful | To set up forwarding and allow it to external addresses |

Connecting the mailbox is the better choice for most teams. [Forwarding](#forward-from-exchange-online) is the better fit when:

* Your organization doesn't let third-party apps access mailboxes.
* The mailbox gets a very high volume of email. Microsoft limits how often one app can call a single mailbox ([10,000 requests per 10 minutes](https://learn.microsoft.com/en-us/graph/throttling-limits#outlook-service-limits)), and forwarding has no such limit.
* You don't want the inbox to depend on one person's account. A connected inbox stops working if that account is removed or loses access.

## Connect a shared mailbox

Before you start, you need:

* A shared mailbox in Microsoft 365, like `support@acme.com`.
* A Microsoft account that can open the shared mailbox and send as it. You sign in with this account, because shared mailboxes can't sign in themselves.
* Permission to manage channels in Replyful.

**1. Give your account access to the shared mailbox**

In the [Exchange admin center](https://admin.exchange.microsoft.com), go to **Recipients** → **Mailboxes** and open the shared mailbox. On the **Delegation** tab, add the account you'll sign in with under both **Send as** and **Read and manage (Full Access)**.

Without **Send as**, Replyful can read the mailbox but can't send replies from it.

For replies your team writes in Outlook to show up on tickets, the shared mailbox also needs to keep a copy of mail sent as it. Exchange saves those copies only in the sender's own Sent Items by default. In the [Microsoft 365 admin center](https://admin.microsoft.com), go to **Teams & groups** → **Shared mailboxes**, open the mailbox, edit **Sent items** and tick **Copy items sent as this mailbox**. Or run `Set-Mailbox -Identity support@acme.com -MessageCopyForSentAsEnabled $true` in Exchange Online PowerShell.

![The Delegation tab of the Support shared mailbox in the Exchange admin center, showing Send as and Read and manage (Full Access)](https://mintcdn.com/replyfulab/9vMg9lL_O63umiGB/images/email/exchange-delegation.png?fit=max\&auto=format\&n=9vMg9lL_O63umiGB\&q=85\&s=5f61990b4161a6e4265fedbc1e5d84fa)

**2. Create the inbox in Replyful**

Go to **Channels** → **Email** and click **Create inbox**. Select **Microsoft 365** and click **Continue**.

![The Create email inbox dialog with Microsoft 365 selected](https://mintcdn.com/replyfulab/9vMg9lL_O63umiGB/images/email/replyful-create-inbox-microsoft.png?fit=max\&auto=format\&n=9vMg9lL_O63umiGB\&q=85\&s=671606d3fd10be3fbc7055382f95337d)

**3. Enter the shared mailbox and sign in**

Enter the shared mailbox address and click **Continue with Microsoft**. Sign in with the account from step 1 and accept the permissions Replyful asks for: reading and sending mail, including in mailboxes shared with you.

![The Connect a shared mailbox dialog with support@acme.com entered and a Continue with Microsoft button](https://mintcdn.com/replyfulab/9vMg9lL_O63umiGB/images/email/replyful-connect-shared-mailbox.png?fit=max\&auto=format\&n=9vMg9lL_O63umiGB\&q=85\&s=8fe3d8abe431f7b5c6ba5ad826c1f342)

If Microsoft says you need admin approval, your organization only lets admins approve new apps. Ask your Microsoft 365 admin to approve Replyful, then try again.

**4. Watch first, then go live**

The new inbox starts out observing. Replyful copies every email and every reply into tickets, but sends nothing. Keep answering in Outlook for a few days to see how it looks, or go live straight away.

![The Observing this mailbox banner with a Go live button](https://mintcdn.com/replyfulab/9vMg9lL_O63umiGB/images/email/replyful-observing-banner.png?fit=max\&auto=format\&n=9vMg9lL_O63umiGB\&q=85\&s=a5d84bd3080b7205bd314f56b8ac2d6f)

When you're ready, click **Go live**. From then on your team answers from Replyful. Replies someone still writes in Outlook land on the ticket too, so nothing gets lost while everyone switches over.

The **Microsoft 365** card on the inbox page shows the connected mailbox and when mail last arrived. Mail normally arrives within seconds, and Replyful also checks the mailbox every 15 minutes in case it missed something.

![The Microsoft 365 card showing Connected, the mailbox support@acme.com, and Reconnect and Disconnect buttons](https://mintcdn.com/replyfulab/9vMg9lL_O63umiGB/images/email/replyful-microsoft-connected.png?fit=max\&auto=format\&n=9vMg9lL_O63umiGB\&q=85\&s=d65d0f9034a608e954073b07d5d789b3)

### If something goes wrong

| Replyful says | What to do |
| - | - |
| The account you signed in with doesn't have access to this channel's mailbox. | Check step 1, then sign in again with an account that has **Full Access** to the shared mailbox. |
| That mailbox is already connected to a channel. | The mailbox already has an inbox in Replyful. Use that inbox, or disconnect it first. |
| That's a different account than the mailbox this channel is connected to. | When you reconnect, sign in with an account that has access to the same mailbox. |
| **Reconnect needed** on the Microsoft 365 card | Replyful lost access, for example because the account was removed or lost access to the mailbox. Click **Reconnect** and sign in with an account that has access. |

## Forward from Exchange Online

Before you start, you need a Microsoft 365 admin account and permission to manage channels in Replyful.

**1. Create a forwarding inbox in Replyful**

Go to **Channels** → **Email** and click **Create inbox**. Select **Email forwarding**, enter your support address and click **Create inbox**. Copy the forwarding address from the inbox page. It ends in `@inbound.replyful.io`.

![The Email address card showing the forwarding address 9f3k2x7q@inbound.replyful.io with a copy button](https://mintcdn.com/replyfulab/9vMg9lL_O63umiGB/images/email/replyful-forwarding-address.png?fit=max\&auto=format\&n=9vMg9lL_O63umiGB\&q=85\&s=24f9ac28586d6127d48e759170a67395)

**2. Allow forwarding to Replyful**

Microsoft 365 blocks automatic forwarding to external addresses by default, and Replyful's address is external. In the [Microsoft Defender portal](https://security.microsoft.com/antispam), create an outbound anti-spam policy that applies only to your support mailbox, and set **Automatic forwarding rules** to **On - Forwarding is enabled**.

If you skip this, Exchange returns forwarded mail with the error `550 5.7.520` and nothing reaches Replyful. See Microsoft's guide to [controlling external email forwarding](https://learn.microsoft.com/en-us/defender-office-365/outbound-spam-policies-external-email-forwarding).

**3. Forward the mailbox**

In the [Exchange admin center](https://admin.exchange.microsoft.com), go to **Recipients** → **Mailboxes**, open your support mailbox and click **Email forwarding**. Turn on **Forward all emails sent to this mailbox** and choose **Forward to an external email address**. Paste the forwarding address.

Tick **Deliver message to both forwarding address and mailbox** to keep a copy in Outlook. Click **Save**.

![Manage email forwarding in the Exchange admin center with Forward to an external email address set to the Replyful forwarding address and Deliver message to both forwarding address and mailbox ticked](https://mintcdn.com/replyfulab/9vMg9lL_O63umiGB/images/email/exchange-email-forwarding.png?fit=max\&auto=format\&n=9vMg9lL_O63umiGB\&q=85\&s=19144ead0d919e2023b85b0253d5b132)

**4. Send a test email**

From an address outside your organization, send an email to your support address. It should show up as a ticket in your Replyful inbox within a minute.

With forwarding, your team's replies are sent from the inbox's Replyful address. To send from your own domain, follow the **add and verify a custom domain** link on the inbox page.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.