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

# My mailbox

> Connect your own work Gmail or Outlook so the emails you exchange with contacts show up on their activity, for the whole team to see.

**My mailbox** lets each teammate connect their own work mailbox to Ciarem. From then on, the emails you send to and receive from your contacts appear on each contact's **Activity**, next to their chats. Your teammates and managers can see what was said and promised, and the history stays with the contact if you leave.

Ciarem only reads your mailbox. It never sends, deletes or changes anything in it. This is different from the [Email channel](https://help.ciarem.ai/channels/email.md), which connects a shared mailbox such as `sales@` to the Inbox so the AI can answer it.

## Connect your mailbox

**1. Open My mailbox**

Click your name at the bottom of the sidebar, then **My mailbox**.

**2. Sign in**

Click **Continue with Google** or **Continue with Microsoft** and sign in with the account you use for work. Approve the access Ciarem asks for: reading your email, and your email address. Signing in with Google isn't available yet (the option reads "Continue with Google isn't available yet"); for now, connect a Microsoft 365 or Outlook mailbox.

**3. Wait for the first look back**

Ciarem looks through your last **30 days** of email once, which can take a few minutes. After that, new email shows up on its own.

* Once an admin has turned email logging on (see [Turn logging on or off](#turn-logging-on-or-off)), any teammate can connect, Admin or Agent. Each person connects one mailbox per organization.
* The mailbox must be on **Google Workspace (Gmail)** or **Microsoft 365 (Outlook)**.
* An address that is already connected as an [Email channel](https://help.ciarem.ai/channels/email.md) can't be connected here: its mail already reaches the Inbox.
* If Microsoft says your company needs an admin to approve Ciarem, ask your IT admin to approve it, then connect again.

## What gets logged

An email is logged when at least one person on it (in From, To or Cc), other than you, is already a contact in Ciarem. Ciarem keeps the sender, the recipients, the subject, the time, the text of the message (without the quoted earlier messages), and the names and sizes of attachments. The attachment files themselves are not kept.

Each matching contact gets the email on their Activity. When several teammates are on the same email, it shows once, with who sent it and who received it.

Email is matched when it arrives. If someone becomes a contact later, or an address is added to a contact later, their earlier emails are not added.

### What is never logged

Nothing about these emails is stored:

* Email with people who aren't contacts.
* Email only between teammates.
* Newsletters, no-reply senders, bounces and other automatic messages.
* Email that also went to one of your organization's [Email channel](https://help.ciarem.ai/channels/email.md) addresses (it is already in the Inbox).
* Email sent from Ciarem itself.
* Email with an address or domain on your never-log list or the organization's.
* Email that arrives while your mailbox is paused or while your organization has logging turned off.

## Who can see a logged email

* **Admins.**
* **The teammates whose mailbox holds it**: the person who sent it and the teammates who received it.
* **Agents who can open one of its contacts** (for example the contact's owner). See [Team roles](https://help.ciarem.ai/using-ciarem/roles-and-permissions.md).

Logged emails are not used by the AI agent, are not sent to HubSpot, and are not sent in [webhooks](https://help.ciarem.ai/webhooks/overview.md) or the API.

## Where you see it

On a contact's **Activity**, an email shows as "sent an email" or "received an email" with its subject. Under it you see From, To and Cc and the first lines of the message; expand it to read the whole text and the attachment names.

On the [mobile app](https://help.ciarem.ai/mobile/inbox-on-mobile.md), a logged email shows in the **Activity** tab of a conversation's contact details. Tap it to read it, with **Remove from log** when you may remove it.

## Pause logging

On **My mailbox**, click **Pause**. Nothing from your mailbox is logged until you click **Resume**.

When you resume, logging starts again **from that moment**. Email that arrived while you were paused is never logged, not even later. If you pause during the first 30-day look back, the rest of the look back is skipped too.

## Never log some addresses or domains

On **My mailbox**, under **Never log**, add the addresses or domains you never want logged, for example `me@personal.com` or `family.com`. Only you see your list.

* A **domain** also covers its subdomains: `family.com` covers `mail.family.com`.
* A bare ending like `com` or `.co` is refused, because it would match almost every address.
* Your own address never counts: adding it doesn't stop anything.

Adding an entry also **deletes the emails already logged** that match it, but only those held by your mailbox alone. An email a teammate's mailbox also holds stays.

Removing an entry from the list only affects new email: emails deleted when you added it don't come back.

## Remove an email from the log

On a contact's Activity, open the email's menu and choose **Remove from log**. The email is deleted **for everyone**, and it is not logged again, from your mailbox or anyone else's.

You can remove an email your mailbox holds. Admins can remove any logged email.

## Disconnect

On **My mailbox**, click **Disconnect**. Ciarem stops reading your mailbox and deletes its access to it.

* By default, the emails already logged stay on your contacts.
* Check **Also delete the emails logged from this mailbox** to delete them. An email a teammate's mailbox also holds stays.

To connect again later, click **Reconnect**. Ciarem looks through the last 30 days again; emails already logged are not repeated.

If you leave the organization, your mailbox is disconnected and the emails already logged stay on your contacts.

## For admins

In **Settings**, then **General**, the **Email logging** card has three controls.

### Turn logging on or off

**Let team members log their email with contacts** is off until an admin turns it on. Nobody can connect a mailbox before that.

* **Off:** nothing is logged from any mailbox, and logged emails are hidden from contacts. Connections are kept, and teammates can't connect new mailboxes.
* **On again:** logged emails show again, and each connected mailbox logs from that moment. Email from the time it was off is never logged. A teammate who paused their own mailbox stays paused until they resume it.

### Never log for the organization

Add domains whose email is never logged from any mailbox, for example your lawyers or your bank. The same rules apply as for a personal list: subdomains are covered and a bare ending like `com` is refused. Adding a domain also deletes every logged email in the organization that matches it.

Admins can't see a teammate's own never-log list.

### Connected mailboxes

The table lists every teammate's mailbox, with its address, its status (**Connected**, **Paused**, **Needs attention** or **Disconnected**) and when it was last checked. **Disconnect** stops reading that mailbox and deletes its access; the emails already logged stay.

Admins never see the email Ciarem skipped: it is not stored.

## Troubleshooting

> [accordion] An email with a contact isn't on their Activity
>
> Check that the person was already a contact, with that email address, when the email arrived. Then check that your mailbox isn't paused, that the address isn't on a never-log list, and that someone didn't remove that email from the log.

> [accordion] My mailbox says Needs attention
>
> Google or Microsoft stopped giving Ciarem access, for example after a password change. Click **Reconnect** and sign in again.

> [accordion] My mailbox says logging is turned off
>
> Email logging is off for the organization. Ask an admin to turn it on in **Settings**, then **General**.

> [accordion] My never-log entry is refused
>
> Enter an address (`me@personal.com`) or a domain (`family.com`). A bare ending like `com` can't be added.


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