---
title: "Sender reputation and automatic pauses"
description: "Every agent carries its own score, computed from real outcomes, and an agent whose bounce or complaint rate crosses the limit is paused."
url: https://help.mails.ai/en/articles/19-sender-reputation-and-automatic-pauses
collection: "Deliverability and policy"
updated: 2026-10-10
language: en
---

# Sender reputation and automatic pauses

Every agent carries its own score, computed from real outcomes, and an agent whose bounce or complaint rate crosses the limit is paused.

![Mails.ai — Sender reputation and automatic pauses](https://staticfiles.gleap.io/p6a77ce6bbe980ea9dbca1955/T23sKqoKIFxamRB3ye2kmp63gbunAqAxovBzfomM9qeeZbbCBhARbJOfOa5wTAIsQ4lzmYIdsyF.png)

Reputation here is a number about **your** agent, computed from what actually happened to its mail — sends, replies, bounces and complaints — over a rolling 30 days. It is isolated per workspace: nothing another customer does moves your score, and nothing you do moves theirs.

![The Metrics page's bounce rate and complaint rate charts, each with a Risk line at the pause limit](https://staticfiles.gleap.io/p6a77ce6bbe980ea9dbca1955/6OAvCGFhIpjSPq0FHnW8T5CiaMak3uWDiOL74B3QPMj9uBEaOa7ivOLGsF1VD4H6NJVRq7IcCk3.png)

## When an agent is paused

Every 15 minutes each agent's bounce and complaint rates over 30 days are checked, and once an hour your whole workspace's, over 30 days and over the last 24 hours. An agent with at least 20 sends in 30 days that passes 5% bounces or 0.3% complaints is paused, and resumes on its own once it is back under 3% and 0.2%. When the whole workspace crosses those lines, with at least 50 sends in 30 days or 20 in 24 hours, every agent in it is paused. A paused agent's sends are refused with `422 agent_paused`. A workspace pause on the last 24 hours can lift by itself at the hourly check; one on 30 days is lifted by support, at support@mails.ai.

## Reading it

The **Metrics** page charts your bounce and complaint rates, each with a Risk line at the pause limit, and the Agents page shows each agent's reputation score. `GET /v1/reputation?agent_id=…` returns one agent's score with its 30-day send, bounce, complaint and reply counts, and the MCP server exposes it as a tool so an assistant can check its own standing before it sends.

## How to keep it high

-   Send to addresses that asked to hear from you. This is the whole game.
    
-   Respect bounces — the suppression list does this for you if you let it.
    
-   Split agents by job, so a noisy notification stream cannot lower the score of the mail your customers actually reply to. Your workspace total still counts: if it crosses the limits, every agent is paused.
    
-   Do not test against a single address thousands of times; it teaches filters exactly the wrong thing about your domain.
    

[Check sender health](https://app.mails.ai/metrics)
