Emails

Send an email

Queues one message for delivery and returns its id immediately. The sending domain must be verified. Pass scheduled_at to send later. Set an Idempotency-Key header to make a retried request return the original email instead of sending twice.

post/emails

Request

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

Headers

Idempotency-Keystring

Client-chosen key, up to 255 characters. A repeat with the same key returns the original result.

Request body

fromstring required

Sender address, bare (hello@acme.com) or with a display name (Acme <hello@acme.com>). The domain must be verified on your account.

subjectstring

Line breaks are rejected.

htmlstring
textstring
template_idstring uuid

Render a stored template instead of inline html/text.

variablesobject

Values substituted into the template or into {{placeholders}} in the body.

headersobject

Extra MIME headers. Line breaks in names or values are rejected.

track_opensboolean

Overrides the organization default.

track_clicksboolean

Overrides the organization default.

scheduled_atstring

Send in the future, at most 30 days out. An ISO 8601 timestamp or natural language (in 1 hour, tomorrow at 9am). Relative phrasings resolve against the server clock in UTC.

Response

Queued.

idstring uuid required

The queued email id.

Changes

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