# Senders (email)

> Mailboxes (connected Accounts) that send this campaign's emails, rotated in round-robin to spread volume and protect deliverability.

Source: https://warmerly.com/docs/campaigns/senders-email

Mailboxes (connected [Accounts](https://warmerly.com/docs/accounts)) that send this campaign's emails, rotated in round-robin to spread volume and protect deliverability.

## List senders

```text
GET /campaigns/{id}/senders
```

`provider` and `status` are the mailbox's own values (see [the account object](https://warmerly.com/docs/accounts#the-account-object)). If the campaign is still a draft with no senders, this call first attaches the project's healthy mailboxes that can send campaigns, so the list is not always empty.

```json
{
  "senders": [
    {
      "id": "d1e2f3a4-1111-4b7a-8e2a-1a2b3c4d5e6f",
      "accountId": "a9b8c7d6-1111-4b7a-8e2a-1a2b3c4d5e6f",
      "email": "kris@yourdomain.com",
      "provider": "gmail",
      "status": "active",
      "healthScore": 92,
      "sentToday": 12,
      "sentTotal": 340,
      "lastSentAt": "2026-07-02T09:41:00.000Z"
    }
  ]
}
```

## Replace senders

```text
PUT /campaigns/{id}/senders
```

Replace-all: pass the full set of `accountIds` (UUIDs) that should send this campaign. An empty array removes every sender. The mailboxes can be in any project of the campaign's workspace; an id that is not reachable returns `400 bad_request` (`invalid_account_ids`). A sender that is not allowed to send campaigns at all (for example a free mailbox while sending from free mailboxes is switched off) is refused with `409` and code `sender_cannot_send_campaigns`, and nothing is changed.

```bash
curl -X PUT https://app.warmerly.com/api/v1/campaigns/b6a1e7b0-2f2b-4b7a-8e2a-1a2b3c4d5e6f/senders \
  -H "X-Api-Key: wmv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "accountIds": ["a9b8c7d6-1111-4b7a-8e2a-1a2b3c4d5e6f"] }'
```

```json
{ "ok": true }
```

## More from Campaigns

- [Steps](https://warmerly.com/docs/campaigns/steps): Steps are the ordered sequence of touches (email, LinkedIn) leads move through, with a delay before each one.
- [LinkedIn senders](https://warmerly.com/docs/campaigns/linkedin-senders): Connected LinkedIn accounts used for linkedinconnection / linkedinmessage steps.
- [Leads](https://warmerly.com/docs/campaigns/leads): status is one of queued, active, completed, replied, bounced, unsubscribed, skipped. Each lead is the stored…