Emails

Send an email

Queues one email for delivery, now or at scheduled_at, from a verified domain of the team.

post/emails

Request

  • Base URL: https://api.mepmail.dev
  • URL: https://api.mepmail.dev/emails
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional retry key, scoped to the team across single and batch sends for 24 hours from the initial claim. The same key and canonical payload replay the original email ids; a different payload returns 409 invalid_idempotent_request and a request still processing returns 409 concurrent_idempotent_requests. An incomplete claim can be recovered after 10 minutes. After expiry, the key can accept a new send. This is an HTTP header, not an email header.

Request body

fromstring required

Sender, "Name user@domain" or bare address; the domain must be verified for the team

subjectstring required

Subject line

htmlstring

HTML body; at least one of html/text is required

textstring

Plain-text body; at least one of html/text is required

scheduled_atstring

Deliver later: ISO 8601 with offset, or relative like "in 2 hours" (an ISO 8601 datetime with offset (e.g. "2026-09-01T12:00:00Z") or a relative time like "in 5 mins", "in 2 hours", or "in 1 day"); max 30 days ahead

topic_idstring uuid nullable

Topic id: recipients opted out of the topic are skipped and an unsubscribe link is added

headersobject

Extra message headers (transport headers are rejected)

templateunknown

Example request

{
  "from": "Acme <onboarding@acme.dev>"
}

Response

Email accepted

idstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.