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

# Agent Email

> Give your Markifact agent its own email address, email it from your work inbox, and get answers as replies in the same thread.

Agent Email gives an agent its own address, such as `analyst@markifact.ai`. You and your teammates email it the way you would email a colleague: ask for a report, forward a client thread, or CC it on a discussion. The agent does the work and replies in the same email thread.

> [!NOTE]
>
> Agent Email is available on paid plans.

***

## Set up an address

**1. Open the agent's settings**

Open the agent, then click the gear icon at the top of the page to open **Agent Settings**.

**2. Open Email**

Under **External Channels**, click **Email**.

**3. Choose the address**

Type the part before `@markifact.ai`, for example `analyst`. Markifact checks that it is available as you type. Use 3 to 32 characters: letters, numbers, dots, dashes or underscores.

**4. Create it**

Click **Create address**, then copy the address and save it as a contact.

> [!WARNING]
>
> An address cannot be changed once it is created. Choose a name your team will recognize.

Each agent has one address. To stop an agent from answering, click **Turn off**. The address stays reserved for that agent, and you can turn it back on at any time.

***

## How it works

| You do | What happens |
| - | - |
| Send a new email to the agent | A new conversation starts, and the agent replies |
| Reply in the same thread | The agent continues the same conversation, with everything said before |
| Send a new email with the same subject | A new conversation starts. Only replies in the thread continue a conversation |
| CC teammates or a client | The agent's reply goes to everyone on the email |
| Forward a thread or add the agent to an existing thread | The agent reads the earlier messages included in the email, so "see below" works |
| Attach files or screenshots | The agent can read them, like files uploaded in the app |

Each email thread appears as a conversation under the agent in the Markifact app. Use the **Email** filter in the sidebar to find them. The conversation is private to the teammate who started the thread.

> [!NOTE]
>
> Messages you type in the app inside an email conversation are not emailed. To answer by email, reply to the thread from your inbox.

### Example

You send this to `analyst@markifact.ai`, with your client on CC:

> Can you compare Meta Ads spend and ROAS for Acme, last 7 days vs the 7 days before?

A minute later, you and your client receive a reply in the same thread with a table of spend and ROAS for both periods and a short summary of what changed. You reply "Break it down by campaign", and the agent answers in the same thread, already knowing which account and dates you meant.

***

## Who can email the agent

Only members of your workspace who can access the agent can ask it to do something. Everyone else is ignored, and the agent never replies to them.

| Sender | What happens |
| - | - |
| Workspace member who can access the agent | The agent runs and replies |
| Teammate who cannot access a private agent | Ignored |
| Someone outside your workspace, in a new email | Ignored, no reply |
| Someone outside your workspace, replying in a thread the agent is already in (for example a client on CC) | Their message is kept in the conversation so the agent can see it later, but it does not trigger the agent and gets no reply |

The agent never acts on instructions from people outside your workspace. If your client asks a question in the thread, reply "Can you answer that?" and the agent will.

Markifact also checks that each email really comes from the address it claims to be from. If it cannot confirm that, the agent does not act on the email, and the teammate whose address was used receives a notice.

***

## Approvals

Actions that change your accounts, such as pausing a campaign or changing a budget, need your approval, just like in the app.

When the agent needs approval, it replies with the actions it wants to take. Reply **approve** to go ahead, or reply with anything else to cancel. The email also links to the conversation, so you can review it in Markifact first.

***

## Files

* **Files you send**: attach images, spreadsheets, PDFs or other documents to your email. The agent can open them like files uploaded in the app.
* **Files the agent creates**: reports, spreadsheets and charts are attached to its reply. Very large files are sent as download links that work for 7 days.

***

## FAQ

> [accordion] Why didn't the agent reply?
>
> Check that:
>
> * You sent the email from the address you use to sign in to Markifact.
> * You can access the agent. A private agent only answers its creator.
> * The agent's email is turned on in **Agent Settings**.
> * Your workspace is on a paid plan.
>
> If none of these apply, contact support with the time you sent the email.

> [accordion] I received "We couldn't confirm that this email came from you"
>
> Markifact could not verify that the email came from your address, so the agent did not act on it. This usually means your company's email domain does not sign its mail (DKIM). Gmail, Google Workspace and Microsoft 365 support it; ask whoever manages your company email to turn it on, then send the email again.

> [accordion] Can my clients email the agent?
>
> Not directly. Only members of your workspace can ask the agent to do something. You can CC clients, and they receive the agent's replies. Their replies in the thread are kept as context, so you can ask the agent to respond to them.

> [accordion] Can I change the address?
>
> No. An address is set once when you create it. You can turn it off and back on, and it stays reserved for the agent. The address is only released if the agent is deleted.

> [accordion] Does it cost credits?
>
> Yes, the same as asking the agent in the app. Each email the agent answers uses credits for that run. See [Credits](https://docs.markifact.com/core-concepts/credits.md).

> [accordion] Can the agent see earlier emails in the thread?
>
> When you add the agent to an existing thread or forward one, it reads the earlier messages included in your email. After that, it remembers the whole conversation. If you delete the quoted text before sending, the agent cannot see those messages and asks you to forward them.

> [accordion] Who receives the agent's reply?
>
> Everyone on the email: the sender and everyone in To and CC. If you added the agent as BCC, only you receive the reply, so the others do not see that you copied it.

> [accordion] Is my email stored?
>
> The email becomes part of the agent conversation in Markifact, like a chat in the app, along with its attachments. The original email is deleted from our mail storage within a day.


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