---
title: "Public Update Campaign Mailbox"
method: PATCH
path: "/campaigns/{campaign_id}/mailboxes/{mailbox_id}"
tags: ["Campaigns"]
---

# Public Update Campaign Mailbox

`PATCH /campaigns/{campaign_id}/mailboxes/{mailbox_id}`

## Request

- Base URL: `https://public.outreach2day.com`
- URL: `https://public.outreach2day.com/campaigns/{campaign_id}/mailboxes/{mailbox_id}`
- Auth: HTTP bearer

Campaigns endpoint for PATCH /campaigns/{campaign_id}/mailboxes/{mailbox_id}.

## Path parameters

- `campaign_id` string, required
- `mailbox_id` string, required: Mailbox identifier. Use campaignMailboxId from CampaignMailboxOut.id (recommended) or mailbox email address (legacy). On an EVA Next workspace the campaignMailboxId is the native mailbox UUID; both it and the address name the same attachment.

## Query parameters

- `workspaceId` integer, required

## Request body

- CampaignMailboxPolicyUpdateIn
  - `weight` integer, nullable
  - `dailyLimit` integer, nullable
  - `gapBaseSeconds` integer, nullable
  - `gapJitterSeconds` integer, nullable
  - `state` string, nullable

## Response `200`

Successful Response

- CampaignMailboxOut
  - `id` string, nullable: CampaignMailboxId. Stable identifier for this mailbox attachment. Use as {mailbox_id} in PATCH/DELETE /campaigns/{campaign_id}/mailboxes/{mailbox_id} (recommended).
  - `campaignId` string, nullable
  - `mailboxId` string, nullable: Mailbox address (email). Legacy identifier accepted in {mailbox_id} path params.
  - `weight` integer, nullable
  - `state` 'ACTIVE' | 'PAUSED' | 'DISCONNECTED' | 'ERROR' | 'UNKNOWN', nullable
  - `stateRaw` string, nullable: Original upstream state value before canonicalization. Present when aliased or unknown.
  - `dailyLimit` integer, nullable
  - `gapBaseSeconds` integer, nullable
  - `gapJitterSeconds` integer, nullable
  - `createdAt` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/outreach2day/apis/outreach-today-public-api.md) · [All operations](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/revisions/0e5471143371?raw)