Skip to main content
GET
Get outreach sending capacity
Everything from writing the pitch to reading the reply. Outreach sends from your own mailbox, at a pace that keeps the mail deliverable, so a queued batch drains over hours rather than seconds.
The endpoints on this page send real email to real people. Once a message leaves the mailbox it cannot be recalled. Anything still queued can be pulled back.

Sending capacity

How much sending headroom the brand has right now. Check this before queueing a batch - mail beyond the daily cap waits for the next day rather than going out. Query parameters: sendingAccountId to narrow the totals to one mailbox. It does not narrow mailboxes, which always lists every connected mailbox, and the funnel counts are always team-wide. In mailboxes[], bounceRate is the share of recent sends that bounced, or null when there are too few to judge. hold is none, bounces, unauthenticated or complaints-paused (which does not occur today).
A mailbox’s daily cap is the lower of its own dailyLimit and 30 recipients. A newly connected one starts well below that and climbs to full pace over roughly four weeks. This is a deliverability ceiling, not a plan limit - the way to send more is another mailbox, not a bigger number on this one.A mailbox is held to 10 a day when its bounce rate is 10% or more across at least 50 sends in the last 7 days (bounces), or when its domain has no SPF or DMARC record (unauthenticated). If both apply, unauthenticated is reported. Mailboxes with pacing switched off (warmupEnabled false) skip the ramp and both of these caps.

Templates

A template is a reusable subject and body. A draft copies the template when it is composed, so editing one later never rewrites mail already queued or sent.

Merge variables

Subjects and bodies may contain these, substituted per recipient when a draft is composed and again at send time: Older names ({{name}}, {{role}}, {{site_name}}, {{domain}}, {{source_url}}, {{matched_query}}, {{your_name}}) still resolve in saved templates but should not be used in new ones. Unknown variables collapse to an empty string rather than leaking braces into a real email.

Draft a pitch

POST /v3/outreach/prospects/{id}/draft Open the request and response reference. Writes a pitch for one prospect, personalised to the page it was found on - what the page is, whether it mentioned you, whether it named competitors and how many, and when it was last updated. Body Returns a subject and body and sends nothing. Pass them to Queue pitches once the wording has been approved. Costs 1 AI credit. A 400 means your brand name is not set in settings.

Save an unsent draft

List saved drafts, save a draft without sending anything, or delete a draft.

Queue pitches

POST /v3/outreach/outbox/queue Open the request and response reference. Queues one pitch per contact. By default they are paced across each mailbox’s daily allowance. sendNow sends immediately only when exactly one new recipient is queued; a batch is always paced. Body Response Write the subject and body yourself, one per contact, personalised to the page named on the prospect.
Items missing a subject, a body or a valid contact are skipped rather than failing the batch, and the call returns 400 when nothing at all could be queued, when items is missing or empty, or when no item has a prospectEmailId - so compare the returned counts against what you sent. Contacts at do-not-contact prospects are skipped and counted in skipped. Queueing a contact whose pitch is still waiting overwrites its unsent copy (counted in updated) and never sends twice; a contact already sent to is left alone. A batch where every contact is already queued returns 200 with queued: 0. A 409 means no active mailbox is connected.
Managing the queue:

Conversations

Mailboxes

Outreach cannot send at all until at least one mailbox is connected.

Outreach automation

Whether earned links are re-checked automatically and how often.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

sendingAccountId
string

Narrow to one mailbox. Omit for every mailbox on the team.

Response

Default Response

account
object | null
dailyLimit
number
sentLast24h
number
mailboxCount
number
warmingCount
number
fullPaceLimit
number
fullPaceAt
string | null
pausedCount
number
heldCount
number
unauthenticatedCount
number
mailboxes
object[]
queuedCount
number
sentCount
number
repliedCount
number
failedCount
number
bouncedCount
number
linkedCount
number