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

# Domain Warmup

> Understand send limits, the warmup period, and bounce rate enforcement for custom domains.

When you verify a custom domain, it enters a **warmup period** before reaching full sending capacity. This protects your domain's email reputation by gradually establishing a sending history with mail providers.

## Warmup period

After DNS verification passes, your domain moves to `pending_warmup` status. The warmup period lasts **72 hours** by default. Once the warmup window expires, the domain automatically transitions to `active`.

During warmup you can still send email — at a reduced daily limit.

## Send limits by status

| Domain status    | Daily send limit |
| ---------------- | ---------------- |
| `pending_dns`    | Cannot send      |
| `pending_warmup` | 10 emails / day  |
| `active`         | 50 emails / day  |
| `suspended`      | Cannot send      |

<Note>
  Daily send counters reset automatically at **midnight**. The system tracks the date of the last send; when the date changes, the counter resets to zero before the next message goes out.
</Note>

If you attempt to send beyond your daily quota, the request is rejected with an error. The counter resets at midnight and sending resumes normally.

## Bounce rate tracking

AgentPost tracks delivery and bounce events for each domain in real time. These counters are visible on the domain detail page in Settings:

* **Deliveries** — successful email deliveries in the current tracking period
* **Bounces** — messages that bounced in the current tracking period
* **Bounce rate** — percentage of bounced messages out of all delivery attempts

Both counters reset daily.

### Auto-suspension threshold

Your domain is automatically suspended when **both** conditions are met:

1. Bounce rate exceeds **10%**
2. At least **5 total events** (bounces + deliveries) have occurred

The minimum event count prevents a single early bounce from triggering a false suspension.

## If your domain is suspended

A suspended domain cannot send email. To investigate and recover:

<Steps>
  <Step title="Check the suspension reason">
    Go to **Settings → Domains** and open the suspended domain. The domain detail page shows the `suspended_reason` if one was recorded.
  </Step>

  <Step title="Review your recipient list">
    A high bounce rate usually means you are sending to invalid or outdated addresses. Clean your list before attempting to resume.
  </Step>

  <Step title="Contact support">
    If you believe the suspension was triggered in error, reach out to AgentPost support. Manual review and reinstatement is handled on a case-by-case basis.
  </Step>
</Steps>

<Warning>
  Continuing to send to addresses that bounce damages your domain's sending reputation with mail providers. Resolve the root cause before requesting reinstatement.
</Warning>

## Domain status lifecycle

```
pending_dns → pending_warmup → active
                                  ↓
                              suspended
```

A domain can move to `suspended` from any sendable state — either automatically (bounce rate threshold) or manually by AgentPost.