---
title: "Attach sender emails to a campaign"
method: POST
path: "/campaigns/{id}/sender-emails"
tags: ["Campaigns"]
---

# Attach sender emails to a campaign

`POST /campaigns/{id}/sender-emails`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/campaigns/{id}/sender-emails`
- Auth: HTTP bearer

Attaches connected sender emails from your workspace to a campaign. A running campaign only sends through the sender emails attached to it, so this call decides which mailboxes the campaign uses. Idempotent: already-attached senders are left untouched and only missing ones are added. The call is refused whole when any requested sender email is not yours (404) or not connected (409). Attaching to a running campaign triggers a reschedule so the new senders are picked up.

## Path parameters

- `id` integer, required

## Request body

- ModelsAttachCampaignSendersRequest
  - `senderEmailIds` integer[], required: SenderEmailIDs are the sender emails to attach. Every ID must be a connected sender email in your workspace; the call is refused whole if any is not.

## Response `200`

Sender emails attached

- ModelsAttachCampaignSendersResponse
  - `alreadyAttached` integer[]: AlreadyAttached lists the requested sender emails that were attached before this call (the call is idempotent: they are left untouched).
  - `attached` integer[]: Attached lists the sender emails newly attached by this call.
  - `campaignId` integer
  - `message` string
  - `senderEmailIds` integer[]: SenderEmailIDs lists every sender email attached to the campaign after this call.

## Other responses

- `400`: Invalid campaign ID or request body
- `401`: Unauthorized - invalid or missing API key
- `404`: Campaign or sender email not found
- `409`: Sender email is not connected
- `500`: Failed to attach sender emails

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)