Skip to main content
POST
Queue outreach pitches for sending
This endpoint schedules real email to real people. Messages cannot be recalled once sent. Use sendNow only when immediate sending was explicitly requested.
Pass up to 200 items, each with a prospectEmailId, subject, and Markdown body. Find the address IDs with Outreach Contacts. Optionally choose one sendingAccountId; omit it to rotate across connected mailboxes. The response reports queued, updated, skipped, sendNow, and spacingMs. Compare these counts with the items supplied: incomplete or invalid entries are skipped, and queueing an address already in the queue updates its unsent copy rather than sending a duplicate. A batch is paced even when sendNow is true; immediate sending is limited to one new recipient. Use Outreach Sending to review messages still in the queue. Those can be removed before sending.

Authorizations

Authorization
string
header
required

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

Body

application/json
items
object[]
required

One entry per recipient.

Required array length: 1 - 200 elements
sendNow
boolean

Send immediately instead of pacing across the daily limit. Leave false unless the user asked for it.

sendingAccountId
string

Send from one specific mailbox. Omit to rotate across all connected mailboxes.

Response

200 - application/json

Default Response

queued
integer
queuedConversationIds
string[]

Newly queued conversation IDs. Read their delivery status from the outbox emails list; these are not worker job IDs.

updated
integer
skipped
integer
sendNow
boolean
spacingMs
number