Bulk Email
Send high-volume email campaigns with comprehensive validation, variable substitution, and detailed engagement reports.
High-Volume Processing
Send up to 50,000 emails per request with automatic queue management
Smart Delivery
Automatic bounce handling and feedback loops for better deliverability
Detailed Analytics
Comprehensive reporting on opens, clicks, and bounce rates
Domain Protection
Throttling built-in to prevent domain blacklisting
Authentication Required
Bulk Processing Notes
- Messages are processed asynchronously and batched automatically.
- Use templates with variables to save bandwidth and processing time.
- Monitor job progress using the returned job ID.
50,000
Maximum emails per request
50 MB
Maximum request size
20
Maximum concurrent bulk jobs
7d
Job retention period
Bulk Upload Methods
{"campaignName": "Newsletter Q1","from": "[email protected]","subject": "Your Q1 Update is Here!","templateId": "tpl_12345","messages": [{"to": "[email protected]","variables": { "name": "John", "plan": "Premium" }},{"to": "[email protected]","variables": { "name": "Sarah", "plan": "Free" }}],"options": {"scheduledFor": "2024-01-16T09:00:00Z","webhookUrl": "https://api.myapp.com/webhooks/bulk-status"}}
Request Schema
interface BulkEmailRequest {/** Campaign name for reporting */campaignName?: string;/** Default sender email */from: string;/** Default subject line */subject?: string;/** Global template ID */templateId?: string;/** Array of messages (max 50,000) */messages: Array<{to: string; // Recipient emailsubject?: string; // Override subjecthtml?: string; // HTML content (if not using template)variables?: Record<string, any>; // Template variables}>;/** Processing options */options?: {scheduledFor?: string; // ISO 8601 timestampwebhookUrl?: string; // Status updates webhook};}
Processing Pipeline
Validation
Checking email addresses and domains
Credit Check
Verifying sufficient balance
Rendering
Compiling HTML and variables
Processing
Queuing and sending to ISPs
Reporting
Generating delivery summary
Response
{"success": true,"message": "Bulk job accepted for processing","data": {"jobId": "bulk_eml_123456789","status": "processing","totalMessages": 50000,"progress": 0}}
5,000/second
Messages per second
2.1s
End-to-end delivery
99.2%
Last 24 hours
420
Pending messages