Emails

Send a transactional email

One-off email to a single recipient, sent synchronously from a mailbox via the Postmark transactional stream. The from address must be an existing mailbox (root tinysend.com or a verified custom domain). Supports Idempotency-Key header — a repeated key returns the original send instead of sending twice.

post/emails

Request

  • Base URL: https://api.tinysend.com/v1
  • URL: https://api.tinysend.com/v1/emails
  • Auth: HTTP bearer

Request body

fromstring email

Sending mailbox address. Optional with a mailbox-scoped key (defaults to its mailbox), required with a project-wide key.

tostring email required
subjectstring required
htmlstring
textstring
reply_tostring email
tagstring

Free-form tag, filterable (stored as source_tag).

metadataobject

User-controlled key-values, passed to Postmark and echoed in its webhooks (max ~10 fields).

Example request

{
  "from": "auth@tinysend.com",
  "to": "user@example.com",
  "tag": "auth.verification"
}

Response

Duplicate Idempotency-Key — original send returned, nothing sent

idstring required
statusstring required
fromstring required
tostring required
subjectstring nullable required
provider_message_idstring nullable required
created_atstring nullable required

Changes

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