We understand that developers with higher volumes or processing time constraints need to send their messages in batches. To facilitate this we provide a batching endpoint that permits you to send up to 500 well-formed Postmark messages in a single API call. If you are sending Broadcast (bulk) messages with the batch call, use the MessageStream field to set your sending Stream.
Please note that the batch endpoint accepts up to 500 messages per API call, and up to 50 MB payload size, including attachments.
The format of the batched message is a JSON array containing multiple message requests.
New! TypeScript: batch send with partial-failure handling
Use Promise.allSettled instead of Promise.all so a single failed recipient doesn't abort the entire batch. Each result includes the MessageID for successful sends and the error reason for failures — giving you the per-recipient visibility you need to act on partial failures without re-sending to everyone.