> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/start/system-emails.md).

# System Notifications and Email

When MaiAgent sends emails: the trigger, recipient, whether it can be turned off, and where to configure each type of system email, compared with in-app notifications in the Notification Center, plus

MaiAgent proactively sends emails to the relevant people when events occur around accounts, members, customer support, connectors, plans, and quotas. This page lists **all** system emails in one place: when they are sent, who receives them, whether they can be turned off, and where to configure them. Many events also trigger an in-app notification in the [Notification Center](https://docs.maiagent.ai/maiagent-user-guide/en/start/notifications.md) in the top-right of the back office; for a comparison, see [In-App Notifications vs. Emails](#in-app-vs-email).

{% hint style="info" %}

* System emails are sent by the MaiAgent platform (for private cloud and on-premises deployments, they are sent from the sender mailbox configured by your company). The email language does not change with the recipient's interface language.
* Emails that support agents send to customers as replies through [Connect a Messaging Platform: Email](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/email.md) are sent from the mail account configured on that messaging platform. They are not system emails and are outside the scope of this page.
  {% endhint %}

## Use Case: Telling In-App Notifications and Emails Apart <a href="#notification-email-scenario" id="notification-email-scenario"></a>

An organization administrator wants to confirm whether a notification she received is also sent by email. She first opens the [Notification Center](https://docs.maiagent.ai/maiagent-user-guide/en/start/notifications.md) in the top-right of the back office to check the notification type, then compares it against [In-App Notifications vs. Emails](#in-app-vs-email) on this page. For example, "<mark style="color:blue;">Connector enabled</mark>" is sent only as an in-app notification and no email follows; knowing this rule, she no longer has to keep waiting for an email that will never be sent.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-45a2cbe1369d8ea105f0fd43426c60ac0e02febe%2Fsystem-emails-notification-center.png?alt=media" alt="Notification Center panel, with System Announcements and Organization Announcements categories"><figcaption><p>The Notification Center is organized into System Announcements and Organization Announcements; to see whether an email is also sent, check the notification table on this page</p></figcaption></figure>

## Accounts and Members <a href="#account-and-member-emails" id="account-and-member-emails"></a>

| Email                                   | When it is sent                                                                                                                                                                                                                                                  | Who receives it              | Can it be turned off, and where to configure                                                                                                                                                                                                                                                                                                   |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Password reset email                    | On the login page, click <mark style="color:blue;">Forgot Password</mark> and submit an email; see [Forgot Password](https://docs.maiagent.ai/maiagent-user-guide/en/start/forget-password.md)                                                                   | The account owner            | Cannot be turned off                                                                                                                                                                                                                                                                                                                           |
| Invitation email                        | An administrator invites someone who **does not yet have a MaiAgent account** to join the organization by email; see [Member Management](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/member.md)                                                 | The invited email address    | Cannot be turned off. If it was not received, click <mark style="color:blue;">Resend</mark> under <mark style="color:blue;">Invitation Status</mark>, up to 3 sends including the first, at least 5 minutes apart; see [Receiving an Invitation: Joining an Organization](https://docs.maiagent.ai/maiagent-user-guide/en/start/invitation.md) |
| Set-password email (bulk member import) | When an administrator bulk-adds members with Excel, for **accounts newly created this time** in the list; see [Bulk Member and Permission Management](https://docs.maiagent.ai/maiagent-user-guide/en/org/overview/member.md#batch-member-permission-management) | The owner of the new account | Cannot be turned off                                                                                                                                                                                                                                                                                                                           |
| Organization approved / rejected        | When the review of an organization that self-registered and applied for a trial is completed; see [Apply for an Account](https://docs.maiagent.ai/maiagent-user-guide/en/start/apply.md)                                                                         | The organization owner       | Cannot be turned off                                                                                                                                                                                                                                                                                                                           |

## Handoff to Human Support <a href="#handoff-emails" id="handoff-emails"></a>

| Email                               | When it is sent                                                                                                    | Who receives it                                                    | Can it be turned off, and where to configure                                                                                                                                                                                                                                                                                                                                     |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Handoff to human notification email | When a conversation handed off to a human is **assigned to a support agent** (including transfer to another agent) | The assigned agent, with a CC to the configured members and groups | Yes. On the messaging platform, go to <mark style="color:blue;">Handoff to Human Support Settings</mark> → <mark style="color:blue;">Notifications</mark> → <mark style="color:blue;">Email Notification</mark>; see [Handoff to Human Support Notifications](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/human-handoff/handoff-notification.md) |

A handoff notification email is sent only when **all three conditions are met at the same time**; for details, see [Email Rules That Are Easy to Misunderstand](#common-misunderstandings).

## MaiGPT Connectors and Tools <a href="#connector-and-tool-emails" id="connector-and-tool-emails"></a>

| Email                                              | When it is sent                                                                                                                                                                                                               | Who receives it                                                                                                | Can it be turned off, and where to configure                                                                                                                                           |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Connector request email                            | A member clicks <mark style="color:blue;">Request Activation</mark> in MaiGPT for a connector that is not enabled for the organization, or requests adding an enabled connector to their own role. Sent only once per request | The organization owner, and members with connector management permission                                       | Cannot be turned off. For how to handle requests, see [Manage Connectors (Administrators)](https://docs.maiagent.ai/maiagent-user-guide/en/work/maigpt/connectors/connectors-admin.md) |
| MCP tool needs re-authorization                    | The authorization of an organization-shared MCP tool becomes invalid and is rejected by the external service at run time. Notified only once per invalidation; sent again only if it becomes invalid again after recovery     | Members who can manage the tool and can see the tool                                                           | Cannot be turned off in the organization back office. For re-authorization, see [Create an MCP Tool](https://docs.maiagent.ai/maiagent-user-guide/en/build/tools/mcp-setup.md)         |
| Schedule skipped a tool with invalid authorization | When an [Agent Schedule](https://docs.maiagent.ai/maiagent-user-guide/en/build/agent/schedule.md) runs, a tool is skipped because its authorization is invalid. Sent only once per tool per schedule within 7 days            | The schedule's creator; if the creator is no longer in the organization, members who can re-authorize the tool | Cannot be turned off. No more emails are sent once you re-authorize the tool, or disable the schedule or remove the tool from the Agent                                                |

## Plans, Credits, and Quotas <a href="#billing-and-credit-emails" id="billing-and-credit-emails"></a>

| Email                         | When it is sent                                                                                                                                                                                              | Who receives it                                                                     | Can it be turned off, and where to configure                                                                                                                                                                                                                                                                                                    |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Low credit balance reminder   | The organization's Credits balance falls below the reminder threshold. Not repeated within 24 hours                                                                                                          | The organization owner, and the notification recipients set in the balance reminder | Yes. <mark style="color:blue;">Enable Balance Reminder</mark> under <mark style="color:blue;">Balance Reminder</mark> (on by default); see [Low Balance Reminder](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits.md#low-balance-alert). **Only organizations on a paid plan receive the email**; see the note below             |
| Personal quota almost used up | A member's personal quota reaches the reminder threshold (80% by default). Sent only once per quota period                                                                                                   | The member                                                                          | Yes, **off by default**. <mark style="color:blue;">Member Quota</mark> → <mark style="color:blue;">Reminder Settings</mark> → <mark style="color:blue;">Enable Personal Quota Reminder</mark>; see [Personal Quota Reminder Settings](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits/member-credit-quota.md#member-quota-alert) |
| Personal quota expiring soon  | Checked daily at 9 AM; a personal quota expires within the configured number of days (7 by default)                                                                                                          | The member                                                                          | Same as above; shares one switch with "almost used up"                                                                                                                                                                                                                                                                                          |
| Plan scheduled                | MaiAgent schedules a plan for the organization that takes effect in the future                                                                                                                               | The organization owner                                                              | No switch in the organization back office; whether it is sent is configured centrally by the MaiAgent platform                                                                                                                                                                                                                                  |
| Plan activated                | A plan takes effect, for example a scheduled plan reaches its effective date, a trial converts to a paid plan, or a renewal. If Credits are granted at the same time, the email includes the credited amount | The organization owner                                                              | Same as above                                                                                                                                                                                                                                                                                                                                   |
| Monthly Credits granted       | The plan's monthly Credits are credited on the grant date                                                                                                                                                    | The organization owner                                                              | Same as above                                                                                                                                                                                                                                                                                                                                   |
| Credits top-up credited       | Credits from a top-up are credited, including Credits that MaiAgent reissues to the organization                                                                                                             | The organization owner                                                              | Same as above                                                                                                                                                                                                                                                                                                                                   |

## Data Retention <a href="#data-retention-emails" id="data-retention-emails"></a>

| Email                               | When it is sent                                                                                                                                                     | Who receives it        | Can it be turned off, and where to configure                                                                                                                                                                           |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Data about to be permanently purged | After an organization has no valid paid plan and enters the data retention period, one email is sent when **89, 60, 30, 14, 7, and 1 days** remain before the purge | The organization owner | Cannot be turned off. For the retention period and how to prevent data from being purged, see [Data Retention Policy](https://docs.maiagent.ai/maiagent-user-guide/en/others/trial-and-plans.md#data-retention-policy) |

## Email Rules That Are Easy to Misunderstand <a href="#common-misunderstandings" id="common-misunderstandings"></a>

### Low Credit Balance Reminders Are Emailed Only on Paid Plans <a href="#low-balance-paid-only" id="low-balance-paid-only"></a>

When the balance falls below the threshold, all organizations receive a <mark style="color:blue;">Low credit balance reminder</mark> in the [Notification Center](https://docs.maiagent.ai/maiagent-user-guide/en/start/notifications.md), but the **email is sent only to organizations with a paid plan**. Organizations on a free plan or with no plan see only the in-app notification, even if <mark style="color:blue;">Enable Balance Reminder</mark> is on and notification recipients are filled in. Organizations subscribed through AWS Marketplace are billed by Marketplace and do not receive this reminder.

### People Who Already Have an Account Receive No Email When Added to an Organization <a href="#existing-account-no-email" id="existing-account-no-email"></a>

When the person's email is already registered with MaiAgent, all of the following methods **add them to the organization directly without sending any email**, and no in-app notification is sent either:

* Inviting a member by email
* Bulk-adding members with Excel (only newly created accounts in the list receive a set-password email)
* Syncing members through LDAP or SCIM

After logging in, the person can switch to the new organization in the top-left. If you need to notify them, tell them separately.

### A Handoff Notification Email Requires Three Conditions at the Same Time <a href="#handoff-email-conditions" id="handoff-email-conditions"></a>

| Condition                                                                                    | Default | Where to configure                                                                                                  |
| -------------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">Enable Human Agent Handoff</mark> is on for the messaging platform | Off     | <mark style="color:blue;">Handoff to Human Support Settings</mark> of the messaging platform                        |
| <mark style="color:blue;">Email Notification</mark> is on for that messaging platform        | On      | <mark style="color:blue;">Handoff to Human Support Settings</mark> → <mark style="color:blue;">Notifications</mark> |
| The organization can use handoff notifications                                               | On      | Configured by the MaiAgent platform; there is no switch in the organization back office                             |

In addition, the email is sent only when the conversation is **assigned to a support agent**; no email is sent when the AI decides to hand off but no one has taken over yet, when the conversation is returned to the AI, or when the queue times out (these events can be sent to external systems through [Webhook notifications](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/human-handoff/handoff-notification.md)). If the first two are on and the conversation is assigned but you still receive no email, contact MaiAgent.

### These Events Do Not Send Email <a href="#events-without-email" id="events-without-email"></a>

The following events appear only in the [Notification Center](https://docs.maiagent.ai/maiagent-user-guide/en/start/notifications.md) and are not emailed: Credits expiring soon, payment failed, auto top-up failed, connector enabled (notifies the member who originally requested it), and a member being removed from an organization.

## In-App Notifications vs. Emails <a href="#in-app-vs-email" id="in-app-vs-email"></a>

| Notification in the Notification Center                                                                                                                                                                          | Also sent by email?                                                                                                                                                                                       |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">Handoff to human notification</mark>                                                                                                                                                   | Follows the <mark style="color:blue;">Email Notification</mark> switch; the in-app notification is controlled separately by the <mark style="color:blue;">Notification Center Announcements</mark> switch |
| <mark style="color:blue;">Personal quota almost used up</mark>, <mark style="color:blue;">Personal quota expiring soon</mark>                                                                                    | Yes                                                                                                                                                                                                       |
| <mark style="color:blue;">Low credit balance reminder</mark>                                                                                                                                                     | Only for organizations on a paid plan                                                                                                                                                                     |
| <mark style="color:blue;">Data retention warning</mark>                                                                                                                                                          | Emailed only when 89, 60, 30, 14, 7, or 1 days remain; on other days only the in-app notification is sent                                                                                                 |
| MCP tool needs re-authorization                                                                                                                                                                                  | Yes                                                                                                                                                                                                       |
| <mark style="color:blue;">Credits expiring soon</mark>, <mark style="color:blue;">Payment failed</mark>, <mark style="color:blue;">Auto top-up failed</mark>, <mark style="color:blue;">Connector enabled</mark> | No                                                                                                                                                                                                        |

## FAQ <a href="#faq" id="faq"></a>

### I should have received an email but didn't? <a href="#faq-not-received" id="faq-not-received"></a>

Check in this order: first check your spam folder; compare against this page to confirm that the email's switch and conditions are all satisfied; for invitation emails, check <mark style="color:blue;">Invitation Status</mark> to see whether <mark style="color:blue;">Email delivery failed</mark> is shown. For private cloud and on-premises deployments, a system administrator must first configure email sending; see [Invitation and Notification Email Sending Settings](https://docs.maiagent.ai/tech/platform-development/onprem-operations#email-and-register-url) in the technical manual.

### Can a member opt out of receiving emails? <a href="#faq-opt-out" id="faq-opt-out"></a>

There is currently no per-user unsubscribe setting. Emails that can be turned off are all controlled per organization or per messaging platform; see the "Can it be turned off" column in the tables above. The CC recipients of handoff notifications and the notification recipients of balance reminders can be adjusted in their respective settings.

## Further Reading <a href="#further-reading" id="further-reading"></a>

* [Notification Center](https://docs.maiagent.ai/maiagent-user-guide/en/start/notifications.md)
* [Handoff to Human Support Notifications](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/human-handoff/handoff-notification.md)
* [Credits Billing System](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits.md)
* [Member Credits Quota Management](https://docs.maiagent.ai/maiagent-user-guide/en/others/credits/member-credit-quota.md)
* [Manage Connectors (Administrators)](https://docs.maiagent.ai/maiagent-user-guide/en/work/maigpt/connectors/connectors-admin.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/start/system-emails.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
