Sending

Send one message

Accepts one message for delivery and answers at once with its id. Delivery, deferral, bounce and complaint arrive later as events on the message and as webhooks. With an Idempotency-Key, a retry within 24 hours gets the first answer again, marked by the Idempotent-Replayed header, and sends nothing twice.

post/v1/email

Request

Base URL: https://api.sendora.se
URL: https://api.sendora.se/v1/email
Auth: HTTP bearer

Headers

idempotency-keystring

Any text of 1 to 255 printable characters that identifies this request; the same key with a different body is refused.

Request body

streamIdstring uuid

The stream of this server the message goes on; the default transactional stream when absent.

subjectstring required

The subject line.

textstring

The plain-text part. At least one of text and html is required.

htmlstring

The HTML part.

headersobject

Custom headers by name, at most 20. Sendora writes these itself, so a message may not set them: From, Sender, To, Cc, Bcc, Subject, Date, Message-ID, MIME-Version, Return-Path, Received, Delivered-To, DKIM-Signature, DomainKey-Signature, Authentication-Results, Received-SPF, and any name that starts with Content-, Resent-, ARC- or X-Kumo.

tagstring nullable

A label of up to 100 characters, returned with the message and its events.

metadataobject

Up to 20 key-value pairs of your own, returned with the message and its events.

Response

Accepted for delivery.

messageIdstring uuid required

The id the message log, the events and the webhooks refer to.

status'accepted' required

submittedAtstring date-time required

When the message was accepted.

testboolean required

True when the server is a test server: the message goes through everything but delivery, and nobody receives it.

Changes

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