---
title: "Get Campaign Mailboxes"
method: GET
path: "/api/v1/campaigns/{campaign_id}/mailboxes"
tags: ["Campaigns"]
---

# Get Campaign Mailboxes

`GET /api/v1/campaigns/{campaign_id}/mailboxes`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/campaigns/{campaign_id}/mailboxes`
- Auth: HTTP bearer

Returns the campaign's sender selection plus everything needed to change it: every mailbox in the organization flagged `selected`, the teammates currently pooled, and the org members available to pool.

Sends round-robin across the resolved pool, respecting each mailbox's daily cap. Connect more mailboxes in the Floqer UI under Connections → Mailboxes.

## Path parameters

- `campaign_id` string, required

## Response `200`

Default Response

- object
  - `status` integer
  - `data` object
    - `mode` 'team_members' | 'specific_mailboxes' | 'none': `team_members` pools every mailbox owned by the selected teammates (including ones they connect later); `specific_mailboxes` uses exactly the selected mailboxes; `none` means no sender is selected yet and the campaign cannot send.
    - `mailboxes` CampaignMailbox[]
      - `id` string: Mailbox ID — pass in `mailbox_ids` to select it
      - `email` string: The mailbox's address
      - `provider` string: Mail provider
      - `owner_email` string: Org member who connected the mailbox
      - `daily_cap` integer: Maximum sends per day from this mailbox
      - `status` string: Connection status; only live mailboxes send
      - `selected` boolean: Whether this campaign currently sends from it
    - `member_emails` string[]: Teammates whose mailboxes are pooled.
    - `available_members` object[]: Org members that can be pooled, for the team-member picker.
      - `email` string
      - `name` string
      - `title` string

## Other responses

- `401`: Unauthorized — missing or invalid API key
- `403`: Forbidden. `code` says which permission refused: ROLE_FORBIDDEN (your role), INSUFFICIENT_SCOPE (the API key's scopes), WORKFLOW_FORBIDDEN (no access to the workflow), KEY_WORKFLOW_FORBIDDEN (the API key's workflow restriction).
- `404`: Campaign not found
- `429`: Too Many Requests — rate limit exceeded. Check `Retry-After` header for seconds until the limit resets.

---

[API](https://skmtc.dev/floqer/apis/floqer-public-api.md) - [All operations](https://skmtc.dev/floqer/apis/floqer-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/floqer/apis/floqer-public-api/revisions/fce50dc07b20?raw)