Skip to main content
GET
Get Senders for Campaign
CLI:

Overview

Returns every sender account attached to the campaign plus the rate-limit context an agent needs to reason about throughput:
  • Per-account weekly limits (with defaults filled in based on is_premium)
  • Rolling 7-day usage for connections + messages, aggregated globally across all the caller’s campaigns (not just this one)
  • Per-campaign sent count — only populated as campaign_messages_sent for LinkedIn campaigns with exactly one sender, where attribution is unambiguous. Email and multi-sender LinkedIn expose campaign_total_sent at the top level instead.
The response also includes campaign_total_sent (total sent messages for this campaign) and campaign_type (channel) so a single call is enough to render a sender dashboard.

AI agent notes

Default limits. When an account has no per-account override, the weekly limits come from is_premium:Daily default for every account is 30 unless overridden.Usage is global, not per-campaign. weekly_connections_sent / weekly_messages_sent sum activity across every campaign this account is attached to — not just this one. That matches how the rate limiter actually decides whether to throttle a send, so it’s the correct signal to surface “is this sender about to hit its cap?”Attribution caveat. campaign_messages_sent is deliberately null for email and multi-sender LinkedIn because there’s no cheap way to map a sent message back to a specific sender when round-robin is in play. Use campaign_total_sent for the aggregate.No mutations here. Adding or removing senders happens via PATCH /api/campaigns/{id} with a sender_account_ids field on draft campaigns. This endpoint is read-only.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Campaign UUID

Response

Sender list and campaign sender statistics.

senders
object[]
required
historical_sender_metrics
object
required

Sent activity owned by removed senders or with unknown ownership. These counts are not assigned to any current sender.

campaign_total_sent
integer
required

Sent direct-message or email outbox rows. LinkedIn connection-request notes are excluded.

Required range: 0 <= x <= 9007199254740991
campaign_total_replies
integer
required
Required range: 0 <= x <= 9007199254740991
campaign_total_bounced
integer
required
Required range: 0 <= x <= 9007199254740991
campaign_total_completed
integer
required
Required range: 0 <= x <= 9007199254740991
campaign_total_committed
integer
required
Required range: 0 <= x <= 9007199254740991
campaign_type
enum<string>
required

Channel mode for this campaign. Immutable after creation.

Available options:
linkedin,
email,
multi_channel
campaignStatsByStatus
object
required
campaignSenderStatsByStatus
object
required
campaignSenderTodayStatsByStatus
object
required
campaignActiveProspectsCount
object
required