---
title: "Public Add Campaign Mailboxes Batch"
method: POST
path: "/campaigns/{campaign_id}/mailboxes/batch"
tags: ["Campaigns"]
---

# Public Add Campaign Mailboxes Batch

`POST /campaigns/{campaign_id}/mailboxes/batch`

## Request

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

Campaigns endpoint for POST /campaigns/{campaign_id}/mailboxes/batch.

## Path parameters

- `campaign_id` string, required

## Query parameters

- `workspaceId` integer, required

## Headers

- `Idempotency-Key` string, nullable

## Request body

- CampaignMailboxBatchAttachIn: Backward-compatible schema name for existing /mailboxes/batch route.
  - `mailboxIds` string[]: Mailbox email addresses to attach. Duplicates are deduplicated case-insensitively.
  - `weight` integer, nullable
  - `dailyLimit` integer, nullable
  - `gapBaseSeconds` integer, nullable
  - `gapJitterSeconds` integer, nullable
  - `state` string, nullable: Campaign mailbox state (provider-specific accepted values).

## Response `200`

Successful Response

- CampaignMailboxBatchAttachOut
  - `status` string, nullable
  - `workspaceId` integer, nullable
  - `campaignId` string, nullable
  - `requestedCount` integer, nullable
  - `processedCount` integer, nullable
  - `batchSize` integer, nullable
  - `addedCount` integer, nullable
  - `skippedCount` integer, nullable
  - `invalidCount` integer, nullable
  - `failedCount` integer, nullable
  - `addedMailboxIds` string[]
  - `skippedMailboxIds` string[]
  - `invalidMailboxIds` string[]
  - `failedMailboxIds` string[]
  - `invalidMailboxes` CampaignMailboxBatchItemErrorOut[]
    - `mailboxId` string, nullable
    - `error` string, nullable
    - `message` string, nullable
    - `statusCode` integer, nullable
    - `detail` unknown
  - `failedMailboxes` CampaignMailboxBatchItemErrorOut[]
    - `mailboxId` string, nullable
    - `error` string, nullable
    - `message` string, nullable
    - `statusCode` integer, nullable
    - `detail` unknown

## 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)