POST /v1/sends mints one sendId, the thing you poll for
lifecycle status and aggregate stats. Reads are flat: one endpoint,
identity in the query.
GET /v1/analytics/sends: list every send for the brand, withstats.GET /v1/analytics/sends?sendId=…: one send’s lifecycle status + stats.GET /v1/analytics/sends?sendId=…&include=events: the same row with its per-recipient event feed inlined.GET /v1/analytics/sends?emailId=…: every send for one design.
emails scope. The send action, POST /v1/sends,
is polymorphic by test and uses the sends scope (or emails).
List Recent Sends
{ data, pagination }. See
Pagination for the cursor loop, or use the
SDK auto-pager:
Poll a Single Send
Look one send up by passing?sendId= to watch it move from queued →
sending → sent and to read its rolled-up stats. An unknown or
cross-brand id returns 404 SEND_NOT_FOUND.
Read the Per-Recipient Feed
Once a send is in flight, drill into its individual delivery events:sent / delivered / opened / clicked / bounced / complained
/ unsubscribed. Add ?include=events to the single-send read to inline
the feed on the same row.
Send a Test Email
The samePOST /v1/sends endpoint sends a test when you pass test: true.
A test send forces the Brew default sender, requires no verified domain or
audience, does not write a send row, and resolves synchronously to
200 { status: 'sent', recipient }.
test. It
returns 202 { status: 'queued' | 'scheduled', sendId, runId }. See
Async jobs & polling.
See Also
GET /v1/analytics/sendsin the Public API v1 reference (sidebar): full parameter + schema reference.- Errors:
SEND_NOT_FOUND,DOMAIN_NOT_READY,AUDIENCE_NOT_FOUND. - Sends (SDK):
emails.send(passtest: truefor a QA send),analytics.sends.{list,listAll}(?sendId,?include=events).
Need help?
Our team is ready to support you at every step of your journey with Brew. Choose the option that works best for you:- Self-Service Tools
- Talk to Our Team
Search Documentation
Type in the “Ask any question” search bar at the top left to instantly find relevant documentation pages.
ChatGPT/Claude Integration
Click “Open in ChatGPT” at the top right of any page to analyze documentation with ChatGPT or Claude for deeper insights.