Outreach

List outreach mailboxes

outreach_mailboxes · Reads only · Markdown

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

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

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

Your agent callsoutreach_mailboxesFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{}
What comes back
{
  "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
}

Use it when

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

What it does

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.

What comes back

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. Every reply also carries cost_usd and balance_usd.

The call

Over MCP, call outreach_mailboxes on https://api.conecto.chat/mcp/outreach. Over REST:

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

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md