PushMail Documentation
API-first email infrastructure. Add contacts, trigger drip sequences, and send campaigns — all from your code.
Send your first email in 30 seconds
curl -X POST https://pushmail.dev/api/v1/contacts \
-H "Authorization: Bearer pm_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"siteId": 1,
"email": "jane@example.com",
"firstName": "Jane",
"tags": ["signup"]
}'curl -X POST https://pushmail.dev/api/v1/sequences/1/enroll \
-H "Authorization: Bearer pm_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"contactIds": [42]
}'That's it. The contact is now receiving your drip sequence automatically.
Explore the docs
Quickstart
Create an account, get an API key, and add your first contact in 5 minutes.
Authentication
API keys, scopes, and how to authenticate your requests.
Contacts
Create, update, tag, and segment your email contacts.
Sequences
Build automated drip campaigns that send over time.
Segments
Rule-based dynamic audiences that evaluate at query time.
Campaigns
Send one-off broadcasts to a list, tag, or segment.
Webhooks
Receive real-time notifications for email events.
Website Tracking
Track page views and custom events with a lightweight JS snippet.
Sending
Managed sending, BYOK SendGrid keys, and delivery tracking.
Plans & Billing
Manage your subscription, upgrade or downgrade, and track usage against plan limits.
CAN-SPAM Compliance
Automatic physical address insertion, one-click unsubscribe, and RFC 8058 headers.
Suppressions
Manage suppression lists for bounces, complaints, and manual blocks.
MCP Server
Connect AI agents like Claude to manage your email infrastructure.
Rate Limits
Per-plan rate limits, headers, and how to handle 429 responses.
API Reference
Complete reference for every endpoint, request, and response.
Base URL
Base URL: https://pushmail.dev/api/v1
All API endpoints are relative to this base URL. All requests and responses use JSON.