Public Email API Overview
The Emalc Public Email API enables engineering teams to programmatically dispatch transactional and notification emails, query real-time delivery telemetry, and integrate email workflows directly into web, mobile, and backend applications.
Whether you are sending password reset notifications, payment receipts, onboarding sequences, or transactional system alerts, Emalc's API delivers your messages through high-reputation Amazon SES infrastructure with dedicated domain authentication (SPF, DKIM, and DMARC).
Key Capabilities#
- High-Performance Delivery: Dispatches email payloads directly via Amazon SES with dedicated DKIM/SPF domain verification.
- Granular Scope Control: Issue API keys (
em_*) with fine-grained permission scopes (email:send,email:read,domain_scope:<domain>,full_access). - Real-Time Telemetry: Track single-email lifecycle events (
sent,delivered,bounced,complained) with accurate event timestamps. - Built-in Deduplication: Explicit
idempotencyKeysupport plus automatic 2-second time window deduplication to prevent accidental double-sends. - Metadata & Tracking: Full control over open tracking pixels, link click rewriting, custom MIME headers, and key-value analytics tags.
Base URLs#
All API endpoints are served over TLS (HTTPS).
| Environment | Base URL |
|---|---|
| Production | https://www.emalc.com |
Available Endpoints#
| Endpoint | Method | Required Scope | Description |
|---|---|---|---|
/api/public/email/send | POST | email:send | Dispatch a transactional email to up to 10 recipients per payload. |
/api/public/email/:id | GET | email:read | Retrieve real-time delivery status and event timeline for an email. |
System Constraints & Capacity Limits#
| Feature | Constraint / Limit |
|---|---|
| Max Recipients per Payload | Up to 10 email addresses per request (passed as array or single string in to). |
| Daily API Request Limit | 5,000 requests / day per organization (resets at 00:00:00 UTC). |
| Total Daily Delivery Capacity | 5,000 emails / day per organization. |
| Per-Second Rate Limit | 2 requests / second per organization. |
| Max Payload Size | 10 MB total (including Base64 attachments). |
| Idempotency Window | 2-second automatic deduplication hash window if idempotencyKey is omitted. |
What does "10 recipients per payload" mean? Instead of calling the API 10 separate times to send an email to 10 different people, you can pass an array of up to 10 email addresses in the
tofield (e.g.["[email protected]", "[email protected]", ...]) in a single API request. The API processes and delivers to all 10 recipients in one HTTP request, which counts as 1 API request toward your 5,000 daily limit.
Sandbox & Mailbox Simulator#
To test deliverability, bounce handling, and complaint webhooks without sending real recipient emails or affecting sender domain reputation, send to Amazon SES Mailbox Simulator addresses:
| Simulator Address | Simulated Behavior |
|---|---|
[email protected] | Simulates a successful delivery. Open and click tracking function normally. |
[email protected] | Simulates a hard bounce (SMTP 550 5.1.1 unknown user). Automatically adds recipient to your org suppression list. |
[email protected] | Simulates an abuse complaint / spam report. |
[email protected] | Simulates an Out-Of-The-Office auto-responder message. |
Note: Sandbox simulator requests still require a verified sender domain and sufficient credit balance in your workspace.