Sending

Send up to 100 messages

Accepts an array of messages and answers one result per message, in order: accepted with its id, or refused with the same error the single send would give. The Idempotency-Key is required. A retry under the same key sends nothing twice: every item accepted before is answered again with replayed set, and only the items that failed are attempted again.

post/v1/email/batch

Request

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

Headers

idempotency-keystring required

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

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

Every message answered on its own; the batch as a whole never fails halfway.

Changes

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