Campaigns

Campaigns are high-volume batch sends with built-in scheduling, segmentation, A/B testing, throttling, and per-campaign analytics.

Create a Campaign

curl -X POST https://api.postmta.com/v1/campaigns -H "Authorization: Bearer pmta_live_xxxx" -H "Content-Type: application/json" -d '{"name":"January Newsletter","subject":"Your January update from Example Co","from":{"address":"newsletter@example.com","name":"Example Co"},"template_id":"tpl_newsletter_jan","list_id":"list_abc123","send_at":"2026-01-20T10:00:00Z"}'

List Segmentation

Filter your audience at send time:

{"segment":{"rules":[{"field":"country","operator":"eq","value":"US"},{"field":"plan","operator":"in","value":["pro","enterprise"]}],"logic":"AND"}}

A/B Testing

{"ab_test":{"enabled":true,"variants":[{"subject":"Your January update","pct":20},{"subject":"January news here","pct":20}],"winner_criteria":"open_rate","winner_pct":80,"holdback_pct":10}}

Send Throttling

{"throttle":{"emails_per_minute":500,"max_concurrent_connections":10}}

Campaign Statuses

Campaign Statistics

curl https://api.postmta.com/v1/campaigns/camp_xxx/stats -H "Authorization: Bearer pmta_live_xxxx"

{"sent":98500,"delivered":97420,"opened_unique":31200,"clicked_unique":8400,"bounced":1080,"complained":12,"open_rate":32.0,"click_rate":8.6}