emails

Send an email

Send a transactional email with raw HTML content. The sender domain must be verified in the project workspace; verified sender domains are shared by every Developer Email API project in that workspace.

post/v3/emails

Request

  • Base URL: https://api.unlayer.com
  • URL: https://api.unlayer.com/v3/emails
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Headers

idempotency-keystring

Unique key for idempotent sends (max 255 characters). If provided, duplicate requests within 24 hours return the cached response.

Request body

fromstring required

Sender email address or "Name <email>" format. Domain must be verified.

tostring[] required

Exactly one recipient. Each request creates one independently tracked delivery.

subjectstring required

Email subject line

htmlstring required

HTML content of the email

textstring

Plain text version of the email. If provided, a multipart/alternative message is sent.

replyTostring email

Reply-To email address

tagsobject

Key-value tags for categorizing the email (e.g. {"campaign": "welcome"}). Max 10 tags. Keys (1-64 chars) and values (up to 256 chars) may only contain letters, numbers, underscores, and hyphens (the Amazon SES message-tag character set).

headersobject

Custom email headers. Up to 9 printable-ASCII X-* headers are allowed (e.g. {"X-Entity-Ref-ID": "abc123"}). Header names may contain up to 126 characters and each name plus value may contain up to 996 characters.

Response

Email accepted and queued for delivery

Changes

No recorded changes to this operation across all 2 revisions of this API.