> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/readme/configuration/office-email.md).

# Office email

Connect your office mailbox (Microsoft 365 sign-in, or forwarding from any provider) so customer email shows up in the Inbox beside texts and on each customer's timeline, and reply from Shortcut.

Connect the one mailbox your office shares, like <office@yourbusiness.com>, and customer email shows up in Shortcut: in the **Inbox** beside their texts, and on each customer's timeline. You can reply, or write a new email, from Shortcut.

Open **Settings → Workspace → API & integrations**, then click **Office email** in the **Integrations** section. [Open Office email →](https://shortcutco.com/settings/integrations/office-email)

There are two ways to connect:

* **Microsoft 365 or Outlook**: sign in as the office mailbox. See [Connect Microsoft 365](#connect-microsoft-365).
* **Any provider**, including Gmail and Google Workspace: forward the mailbox to Shortcut. See [Set up forwarding](#set-up-forwarding).

{% hint style="info" %}
**Who can use it.** Office email comes with the shared Inbox, on the **Growth** and **Optimize** plans. Only company admins can set it up, and only on the web. Like the Inbox itself, it's for company admins. On a plan without it, the page says **Office email comes with the shared Inbox** with an **Upgrade to Growth** button.
{% endhint %}

## Before you start

* **Connect the shared office mailbox, not each person's email.** Shortcut takes one mailbox per business.
* **Only email from people Shortcut already knows comes in.** That's your customers and leads (see [What comes in](#what-comes-in-and-what-doesnt)). Everything else stays in your mailbox and never reaches Shortcut.
* **Only new email comes in.** Shortcut doesn't import old mail. It picks up email that arrives after you connect.
* Don't mix this up with **Settings → Customers → Customer portal → Office email**. That one is just the contact address your customers see in the portal. Neither setting changes the other.

## Connect Microsoft 365

1. On the **Microsoft 365 or Outlook** row, click **Connect Microsoft 365**.
2. Sign in to Microsoft as the office mailbox, and allow both reading and sending mail. Shortcut needs both.
3. You come back to the page with *Microsoft 365 is connected.* New customer email shows up in the Inbox within a couple of minutes.

The **Mailbox** section then shows the office address, **Connected with Microsoft sign-in**, and **Connected**.

With Microsoft 365 connected:

* Shortcut reads the mailbox's inbox and its sent mail. Email the office sends to a customer straight from Outlook shows up in Shortcut too.
* Replies you send from Shortcut go out from the office mailbox itself, and a copy sits in its **Sent Items**.

{% hint style="info" %}
**Your organization limits outside apps?** A Microsoft 365 admin approves Shortcut first: they sign in on this page and accept for the whole organization. Until then, connecting shows *Your Microsoft 365 admin needs to approve Shortcut first.*
{% endhint %}

If Microsoft signs Shortcut out (for example, after a password change), the page shows **Needs reconnect** and a **Reconnect Microsoft 365** button. New email doesn't arrive until you reconnect.

## Set up forwarding

Forwarding works with any mail provider: Gmail, Google Workspace, Microsoft 365, Outlook, or anything else. Your mailbox forwards a copy of each email to a private Shortcut address.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-883ee8ff8d82ed0217e655e1be2044a3eaa7ca58%2Fsettings-office-email-connect.png?alt=media" alt="Settings → API &#x26; integrations → Office email: the Connect your office mailbox card, with the Any other email provider row and its Set up forwarding button"><figcaption><p>Click Set up forwarding on the Any other email provider row.</p></figcaption></figure>

1. Click **Set up forwarding**.
2. Enter your **Office email address** (the address customers email today) and the **Name on replies** (shown as the sender on replies from Shortcut; it starts as your business name). Click **Save**.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-bb1c1b7eeaa8aea7b14c864a8f4d861c534d758a%2Fsettings-office-email-forwarding-form.png?alt=media" alt="The Forwarding form under the connect card: Office email address filled in, Name on replies set to the business name, and Cancel and Save buttons"><figcaption><p>Enter the address customers email today, then Save.</p></figcaption></figure>

3. Shortcut gives you a private **forwarding address**. Click **Copy**.
4. In your mail provider, forward a copy of everything the office mailbox receives to that address. The page lists the steps for **Gmail or Google Workspace**, **Microsoft 365 or Outlook** and **any other provider** under **How to set it up**.
   * In Gmail, Gmail sends a **Confirmation code** to Shortcut. It appears on this page within a minute. Enter it in Gmail to finish.
   * In Outlook, a rule can use **Forward to** or **Redirect to**. Both keep the customer as the sender in Shortcut.
   * If Outlook refuses to forward outside your company, ask your Microsoft 365 admin to allow it for this mailbox.
5. The mailbox shows **Waiting for first email** until the first one arrives, then **Connected**.

### Forward one email at a time

You can also forward a single customer email to your forwarding address, from the office mailbox or from the email you sign in to Shortcut with. It lands under the customer who wrote it, not under you.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-5385383f32e6a3f2c7c5373aaaefb21ccf4e0a9d%2Fsettings-office-email-forwarding-address.png?alt=media" alt="Office email after Save: the Mailbox card with the office address, Forwarded to Shortcut and a Waiting for first email badge; Your forwarding address with a Copy button; and How to set it up with steps for Gmail or Google Workspace and Microsoft 365 or Outlook"><figcaption><p>Copy your forwarding address, then follow the steps for your provider.</p></figcaption></figure>

Keep the forwarding address private: anything sent to it lands in your Inbox.

{% hint style="info" %}
**Gmail and Google Workspace** connect by forwarding. The **Gmail or Google Workspace** row reads **Not available right now. Use forwarding instead.**
{% endhint %}

## What comes in and what doesn't

Shortcut brings in an email when:

* it's from a **customer's** email address (not an inactive customer), or a **lead's** (not a dismissed lead); or
* it's a **reply in a conversation Shortcut already has**, from any address. For example, a customer answering from their work email.

A customer's email that someone in the office forwards on counts as from the customer who wrote it (see [Forward one email at a time](#forward-one-email-at-a-time)).

With forwarding, Shortcut only sees incoming mail, so email the office sends straight from its own mailbox doesn't come in. With Microsoft 365 connected, it does.

Shortcut never brings in, even from a customer:

* bounces and "undeliverable" notices;
* out-of-office and other automatic replies;
* newsletters and mailing-list mail;
* email the office mailbox sends to itself;
* email from a conversation you've blocked.

Everyone else, like a new prospect or a supplier, stays in your mailbox only. To start getting a new prospect's email in Shortcut, add them as a lead. Email they send after that comes in. Earlier email doesn't.

## Email in the Inbox

Customer email sits in the same conversation as that customer's texts, in the **Inbox** (**Messaging** in the sidebar). A small envelope shows on a conversation whose latest message was an email, and a new email makes the conversation unread, just like a text. It also sends the same **New customer message** notification.

<figure><img src="https://2299783971-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOhi7KtJ4vY1pDKwWu5SV%2Fuploads%2Fgit-blob-6a8d594634a98db60d72b758d57f222d2cb9907b%2Finbox-office-email-message.png?alt=media" alt="The Inbox with a customer&#x27;s conversation open: an email card with the sender, the subject and the message, a Formatted toggle, and the reply box switched to Email with the subject filled in as a reply"><figcaption><p>Email shows up in the customer's conversation, beside their texts.</p></figcaption></figure>

Each email shows the sender, the subject and the message:

* **Formatted** shows the email as it was designed; **Plain text** switches back.
* Pictures from the web are hidden until you click **Load images**.
* Attachments show as chips you can click to download.

### Reply by email

When your mailbox is set up, the reply box has a **Text** / **Email** switch. It opens on whichever you used last.

1. Switch to **Email**. The **Subject** is filled in as a reply to the customer's latest email.
2. Write your message. **Enter** starts a new line; press **Cmd+Enter** (Mac) or **Ctrl+Enter** (Windows) to send.
3. The line under the box says **Sends as email from** your office mailbox **to** the customer.

An email you send shows **Sending...**, then **Sent**. If it couldn't go, it shows **Not delivered** with the reason, and your draft stays so you can send it again.

**New message** in the Inbox starts a text. To start a new email, use **Send email** on the customer's profile.

## Email a customer from their profile

On a customer or lead's profile, click **Send email** (on their email address, or in the **⋯** menu). The **Send email** dialog shows who it goes to and the mailbox it comes from. Add a **Subject**, write your message and click **Send**. To start from a saved answer, click the templates button beside the message (see [Message templates](https://docs.shortcutco.com/readme/messaging-inbox.md#message-templates)). The email goes into that customer's Inbox conversation.

Without office email set up, **Send email** opens your own email app instead.

## On the customer's timeline

Each customer's **Activity** shows **Email received** and **Email sent** rows with the subject, how many attachments, and who sent it. Click a row to open the conversation in the Inbox.

## How replies are sent

* **Microsoft 365:** replies go out from the office mailbox itself.
* **Forwarding:** replies go out from your email sending address on [Company & brand](https://docs.shortcutco.com/readme/configuration/company-profile.md) (or Shortcut's own address if you haven't set one up), with your **Name on replies** as the sender. When the customer answers, the reply goes to your office mailbox, and your forwarding brings it back into Shortcut.

Replies from Shortcut are plain text. You can't attach files or add CC from Shortcut. Customers who unsubscribed from your email aren't emailed.

## Keep it connected

The **Mailbox** section shows the office address, how it's connected (**Connected with Microsoft sign-in** or **Forwarded to Shortcut**), and its status:

* **Connected** — email is arriving.
* **Waiting for first email** — forwarding is set up, and nothing has arrived yet. Check the forward in your mail provider, and send a test email from a customer's address.
* **Needs reconnect** — Microsoft signed Shortcut out. Click **Reconnect Microsoft 365**.

## Change or disconnect

Open the **⋯** menu at the top of the page:

* **Edit office address** (forwarding) — change the office address or the name on replies.
* **Reconnect Microsoft 365** (Microsoft 365) — sign in again.
* **Disconnect** — Shortcut stops reading the mailbox and forgets its access right away. Email already in the Inbox stays on each customer's record. With forwarding, turn off the forward in your mail provider too.

To switch to a different mailbox, disconnect first, then connect again.

## Limits

* Attachments up to 10 MB each, 25 MB per email, and 20 per email. Larger ones show as **too large to open here**.
* If two contacts share one email address and Shortcut can't tell them apart, it won't email the second one from Shortcut and says why.

<details>

<summary>Still stuck?</summary>

Email **<hello@shortcutco.com>** with a screenshot of Settings → API & integrations → Office email.

</details>
