---
name: "outreach_mailboxes"
area: "outreach"
title: "List outreach mailboxes"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/outreach_mailboxes"
mcp_server: "https://api.conecto.chat/mcp/outreach"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/outreach/outreach_mailboxes"
---

# List outreach mailboxes (`outreach_mailboxes`)

The business's mailboxes connected for outreach, each with its state, daily limit, what it sent today and its bounce rate; never a password.

The business's mailboxes connected for outreach: each one's mailbox_id, address, the name people see, its state (ready, daily_limit_reached, waiting_for_check, reply_check_failed, paused, paused_for_bounces, paused_for_failures, over_limit or disconnected) and what went wrong, its daily limit and what it sent in the last 24 hours, its bounce rate, and its servers. Never a password.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

To pick the mailboxes a campaign sends from, or to see why sending stopped.

## Say this to your agent

> Which of our mailboxes can send the hotel emails, and how many went out today?

## Inputs

This tool takes no arguments: send `{}`.

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `outreach_mailboxes` on the MCP server `https://api.conecto.chat/mcp/outreach` with these arguments:

```json
{}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/outreach_mailboxes \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "outreach_mailboxes",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "mailboxes": [
      {
        "mailbox_id": 4101,
        "email": "dana@halversoncycle.example",
        "sender_name": "Dana Halverson",
        "state": "ready",
        "daily_limit": 30,
        "sent_last_24h": 0,
        "bounce_rate_percent": 0,
        "problem": null,
        "campaigns": 0,
        "last_sent_at": null,
        "checked_at": "2026-10-14T08:00:00Z",
        "smtp": {
          "host": "smtp.gmail.com",
          "port": 587,
          "security": "starttls",
          "username": "dana@halversoncycle.example"
        },
        "imap": {
          "host": "imap.gmail.com",
          "port": 993,
          "security": "ssl",
          "username": "dana@halversoncycle.example"
        }
      }
    ],
    "limit": 10
  }
}
```

`result`: mailboxes: each with mailbox_id, email, sender_name, state, daily_limit, sent_last_24h, bounce_rate_percent, problem, campaigns, last_sent_at, checked_at and its smtp and imap servers (host, port, security, username); and limit, how many may be connected.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [outreach_connect_mailbox](https://conecto.chat/tools/outreach/outreach_connect_mailbox.md): A one-hour link for the owner to connect their own mailbox for outreach, typing its password on a Conecto page. Free.
- [outreach_update_mailbox](https://conecto.chat/tools/outreach/outreach_update_mailbox.md): Rename an outreach mailbox, change its daily limit, pause or resume its sending, or disconnect it. Free.
- [outreach_save_campaign](https://conecto.chat/tools/outreach/outreach_save_campaign.md): Create or change an outreach campaign: its mailboxes, the emails you write, the audience, a first line per person and when it sends. Free.
- [outreach_preview](https://conecto.chat/tools/outreach/outreach_preview.md): One step of an outreach campaign as it will go, for real people: to, from, the subject and the text with the unsubscribe line. Free up to 1,000,000 reads a month.
- [outreach_start](https://conecto.chat/tools/outreach/outreach_start.md): Start an outreach campaign the person approved; $0.01 per person when their first email leaves. Free.
- [outreach_campaigns](https://conecto.chat/tools/outreach/outreach_campaigns.md): The business's outreach campaigns, newest first, each with its status and numbers. Free up to 1,000,000 reads a month.
- [outreach_get_campaign](https://conecto.chat/tools/outreach/outreach_get_campaign.md): An outreach campaign with its numbers, each step's emails and replies, and its people page by page with their status. Free up to 1,000,000 reads a month.
- [outreach_replies](https://conecto.chat/tools/outreach/outreach_replies.md): The replies to the business's outreach campaigns, newest first, with who wrote, the text and their status now. Free up to 1,000,000 reads a month.
- [outreach_set_status](https://conecto.chat/tools/outreach/outreach_set_status.md): Keep in the CRM whether someone outreach reached is interested or not; their pending emails stop. Free.
- [outreach_pause](https://conecto.chat/tools/outreach/outreach_pause.md): Pause a running outreach campaign; replies are still read and resuming carries on. Free.
- [outreach_resume](https://conecto.chat/tools/outreach/outreach_resume.md): Resume a paused outreach campaign once what paused it is fixed. Free.
- [outreach_stop](https://conecto.chat/tools/outreach/outreach_stop.md): End an outreach campaign for good; nobody it hasn't emailed is emailed or charged. Free.