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

# Change an outreach mailbox (`outreach_update_mailbox`)

Rename an outreach mailbox, change its daily limit, pause or resume its sending, or disconnect it.

Change a connected mailbox: the name people see (sender_name), its daily limit (1 to 200 emails in any 24 hours, shared by every campaign that sends from it), pause or resume its sending, or disconnect it (Conecto forgets its password). A campaign none of whose mailboxes can send pauses and tells you; resume it once a mailbox can send again. Its settings and password change only on a new connect link (outreach_connect_mailbox).

Price: Free. A call that fails costs nothing.

## Use it when

When the owner wants a mailbox to send more or less, or to stop using it.

## Say this to your agent

> Send at most 40 emails a day from my Gmail, I don't want Google flagging it.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `mailbox_id` | integer | yes | At least 1. |  |  |
| `sender_name` | string | no | 1 to 120 characters. |  |  |
| `daily_limit` | integer | no | 1 to 200. |  |  |
| `paused` | boolean | no |  |  |  |
| `disconnect` | boolean | no | true disconnects it for good. |  |  |

## Example

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

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

```json
{
  "mailbox_id": 4105,
  "daily_limit": 40
}
```

REST:

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

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "outreach_update_mailbox",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "mailbox": {
      "mailbox_id": 4105,
      "email": "dana@halversoncycle.example",
      "sender_name": "Dana Halverson",
      "state": "ready",
      "daily_limit": 40,
      "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"
      }
    }
  }
}
```

`result`: mailbox, as outreach_mailboxes shows it.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | No mailbox on this account has that id. | Use a mailbox_id from outreach_mailboxes. |

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_mailboxes](https://conecto.chat/tools/outreach/outreach_mailboxes.md): 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 up to 1,000,000 reads a month.
- [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.