Emalc

Search Documentation

Quickly jump to any guide, document, or section...

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 idempotencyKey support 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).

EnvironmentBase URL
Productionhttps://www.emalc.com

Available Endpoints#

EndpointMethodRequired ScopeDescription
/api/public/email/sendPOSTemail:sendDispatch a transactional email to up to 10 recipients per payload.
/api/public/email/:idGETemail:readRetrieve real-time delivery status and event timeline for an email.

System Constraints & Capacity Limits#

FeatureConstraint / Limit
Max Recipients per PayloadUp to 10 email addresses per request (passed as array or single string in to).
Daily API Request Limit5,000 requests / day per organization (resets at 00:00:00 UTC).
Total Daily Delivery Capacity5,000 emails / day per organization.
Per-Second Rate Limit2 requests / second per organization.
Max Payload Size10 MB total (including Base64 attachments).
Idempotency Window2-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 to field (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 AddressSimulated 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.