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

# SMTP2GO

> Connect SMTP2GO so the agent can check a customer's email delivery, sender verification, SMTP logins and plan usage from a ticket, and make approved fixes.

Connect SMTP2GO and the agent answers "the copier stopped emailing" and "why did this email bounce" from SMTP2GO's own delivery records, and fixes the common causes after a technician approves.

You need an SMTP2GO account on a paid plan with one **subaccount per customer**. The agent works per subaccount: on a customer's ticket it reads and changes only that customer's subaccount.

## How to connect

**1. Create an API key on the master account**

Sign in to SMTP2GO with the **master account**, the one that owns the customer subaccounts, not a subaccount. Open **Sending → API Keys** and click **Add API Key**. Give it a description such as `Rallied`.

**2. Set the key's permissions**

Open the **Permissions** tab of the new key and enable these endpoints:

| Group | Endpoints |
| - | - |
| Activity | `/activity/search` |
| Subaccounts | `/subaccounts/search` |
| SMTP Users | `/users/smtp/view` |
| Sender Domains | `/domain/view` |
| Single Sender Emails | `/single_sender_emails/view` |
| Suppressions | `/suppression/view` |
| Statistics | `/stats/email_history`, `/stats/email_cycle`, `/stats/email_summary` |
| SMS | `/sms/summary` |

If you want the agent to make changes after a technician approves them, also enable `/users/smtp/add`, `/users/smtp/edit`, `/users/smtp/remove`, `/suppression/remove`, `/domain/add`, `/domain/verify`, `/single_sender_emails/add`, `/single_sender_emails/remove` and `/subaccount/edit`. Leave `/email/send` and every `/api_keys/*` endpoint off: the agent never sends email and never manages keys.

**3. Copy the key and note your region**

Click **Add API Key** and copy the key. It starts with `api-`. Note the region your account is hosted in: it shows in the address bar when you are signed in (`app-us`, `app-eu` or `app-au`).

**4. Connect SMTP2GO in Rallied**

In Rallied, go to **Settings → Integrations**, find the SMTP2GO card and click **Connect**. Pick your **Data region** (or leave **Automatic**, which uses SMTP2GO's global endpoint `api.smtp2go.com`) and paste the key into **API key**. Click **Connect**.

**5. Confirm**

Rallied checks the key's permissions and lists the endpoints that are missing, if any. When the key is accepted, Rallied syncs your subaccounts and the card shows **Connected**.

> [!NOTE]
>
> Rallied refuses a key that lacks any of the read endpoints above and names the missing ones. The change endpoints are optional: without them, the agent's read tools work and a change tool reports which endpoint to enable.

## Mapping subaccounts to Rallied clients

When you connect, Rallied syncs your active SMTP2GO subaccounts and suggests a Rallied client for each one. Rallied skips closed and suspended subaccounts. An MSP admin confirms the suggestions in **Match companies**. The **Companies** tab of the integration's page lists the synced subaccounts with their IDs; click **Sync subaccounts** to pick up subaccounts you've created since.

On a client's ticket, the agent reads only that client's subaccount. It fills in the subaccount ID automatically, and SMTP2GO itself refuses a subaccount that doesn't belong to your account.

> [!NOTE]
>
> A customer that sends through your master account rather than a subaccount is not covered: SMTP2GO offers no per-customer boundary there. Create a subaccount for that customer in SMTP2GO (**Settings → Subaccounts**, and migrate its SMTP users with **Migrate**), then click **Sync subaccounts**.

> [!NOTE]
>
> Only the MSP admin [Chat](https://docs.rallied.ai/dashboard/chat.md) can list every subaccount with its usage, or read your master account's plan usage. Use it for questions such as "which customers are close to their monthly limit?"

## How the agent uses it

On a ticket such as "the scanner stopped sending emails" or "our emails to Acme bounce", the agent typically:

1. Searches the customer's delivery activity for the sender, recipient or SMTP login named in the ticket. Each event says whether SMTP2GO delivered the email, whether it bounced or was rejected, and what the receiving server answered.
2. Checks the SMTP login the device uses: whether it's allowed or blocked, and its rate limit. Passwords are never returned.
3. Checks the sender domain's DKIM and return-path verification and the exact DNS records SMTP2GO expects, or whether the sender address is verified.
4. Checks the suppression list when one recipient never receives anything: a hard bounce or a spam complaint suppresses the address automatically.
5. Reads the subaccount's monthly email and SMS usage when sending stopped at the limit, or when you ask for a usage audit.

It writes what it found on the ticket as an internal note, quoting the server responses it read. Email bodies are never available to the agent: activity events carry senders, recipients, subjects and server responses only.

### Changes the agent can propose

Every change needs a technician's approval, requested where your technicians already work (see [Approval settings](https://docs.rallied.ai/dashboard/policies.md)):

* Create an SMTP login for a new device, or delete a retired one. The password of a new login is generated and held by Rallied, like a reset.
* Block or unblock an SMTP login, or change its sending rate limit.
* Reset an SMTP login's password. The agent generates the password and Rallied holds it; the agent only ever handles a reference to it, never the value. After approval, Rallied sets it in SMTP2GO and the technician receives it through your credential-delivery integration or an internal note. Every device using that login must be reconfigured, and SMTP2GO takes about a minute to accept the new password.
* Release a suppressed address or domain.
* Re-check a sender domain's DNS right away, after the customer fixed it.
* Register a sender domain. The agent returns the DNS records the customer must add; SMTP2GO verifies them within minutes.
* Register or remove a sender address. SMTP2GO emails a verification link to a new address; nothing sends from it until the link is clicked.
* Change a subaccount's monthly email limit. SMTP2GO accepts only its own steps (2,000, 5,000, 10,000, 20,000 and so on) and nothing above what your plan allows.

> [!WARNING]
>
> A customer's sending counts against your SMTP2GO plan. Raising a subaccount's limit can raise your bill.

## Tools

Reads default to **Auto**; changes default to **Approval needed**. To change a default, open the **Policies** tab on **Settings → Integrations → SMTP2GO**. See [Approval settings](https://docs.rallied.ai/dashboard/policies.md).

| Tool | Default policy | Description |
| - | - | - |
| `smtp2go-search-activity` | Auto | Search a customer's delivery events: processed, delivered, bounced, rejected, spam, opened, with the server's response |
| `smtp2go-get-subaccount-usage` | Auto | Read a customer's subaccount state and this cycle's plan usage |
| `smtp2go-list-sender-domains` | Auto | List a customer's sender domains with DKIM, return-path and tracking verification and the expected DNS records |
| `smtp2go-list-smtp-users` | Auto | List a customer's SMTP logins with status and rate limits, never their passwords |
| `smtp2go-list-suppressions` | Auto | List a customer's suppressed addresses and domains with the reason |
| `smtp2go-get-email-stats` | Auto | Read a customer's sending summary for a period, per login, domain or address |
| `smtp2go-list-single-senders` | Auto | List a customer's registered sender addresses and whether each is verified |
| `smtp2go-get-sms-usage` | Auto | Read a customer's SMS messages, units and cost for a period |
| `smtp2go-list-subaccounts` | Auto | List every subaccount with state and usage. Admin chat only |
| `smtp2go-get-account-usage` | Auto | Read the master account's plan usage and 30-day totals. Admin chat only |
| `smtp2go-generate-smtp-password` | Auto | Generate a new SMTP password that Rallied holds; the agent gets a reference to it |
| `smtp2go-reset-smtp-user-password` | Approval needed | Set a new password on a customer's SMTP login |
| `smtp2go-add-smtp-user` | Approval needed | Create an SMTP login for a device on a customer's subaccount |
| `smtp2go-remove-smtp-user` | Approval needed | Delete an SMTP login from a customer's subaccount |
| `smtp2go-set-smtp-user-status` | Approval needed | Block or unblock a customer's SMTP login |
| `smtp2go-set-smtp-user-rate-limit` | Approval needed | Set or clear a login's custom sending rate limit |
| `smtp2go-remove-suppression` | Approval needed | Release a suppressed address or domain |
| `smtp2go-trigger-domain-verification` | Approval needed | Re-check a sender domain's DNS now |
| `smtp2go-add-sender-domain` | Approval needed | Register a sender domain and return the DNS records to set |
| `smtp2go-add-single-sender-email` | Approval needed | Register a sender address and send it the verification link |
| `smtp2go-remove-single-sender-email` | Approval needed | Remove a registered sender address |
| `smtp2go-set-subaccount-limit` | Approval needed | Change a subaccount's monthly email limit |

## See also

* [Approval settings](https://docs.rallied.ai/dashboard/policies.md)
* [Chat](https://docs.rallied.ai/dashboard/chat.md)
* [Integrations](https://docs.rallied.ai/dashboard/integrations.md)
* [Integrations overview](https://docs.rallied.ai/integrations/overview.md)


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