Research · Providers

Postal (self-hosted)

Updated November 9, 2026

Postal is an open-source mail server (MIT license) that you run yourself. There is no free tier to compare: sending limits depend on your server, its IP addresses and any send limit set in Postal.

Sending API

Checked November 9, 2026 against the provider's API reference.

  • Auth: X-Server-API-Key with an API credential of the mail server. Requests are JSON POSTs; the legacy API answers HTTP 200 with status success, error or parameter-error.
  • Send: POST {server}/api/v1/send/message with to, cc, bcc (up to 50 each), from, sender, reply_to, subject, plain_body, html_body, tag, headers, attachments (name, content_type, data base64), bounce. send/raw takes a whole RFC 2822 message.
  • Response: data: { message_id, messages: { "<rcpt>": { id, token } } }. Error codes: NoRecipients, NoContent, TooManyToAddresses, FromAddressMissing, UnauthenticatedFromAddress, AttachmentMissingName, AttachmentMissingData, InvalidServerAPIKey, AccessDenied, ServerSuspended.
  • Status: POST /api/v1/messages/deliveries with the message id: deliveries with status Sent, SoftFail, HardFail, Held or Bounced, details and output.
  • Webhooks: { event, timestamp, payload, uuid }; events MessageSent, MessageDelayed, MessageDeliveryFailed, MessageHeld, MessageBounced, MessageLinkClicked, MessageLoaded, DomainDNSError. Signed with the server key: X-Postal-Signature-256 (RSA SHA-256, base64, over the raw body) and the legacy X-Postal-Signature (SHA-1).
  • No suppression list API in the legacy HTTP API.

Using Postal (self-hosted) with OneSend

Connect it under Sending providers with the postal adapter and add it to a routing policy. See Sending providers.

Sources

Checked November 9, 2026.

Suggested citation

OneSend. "Postal (self-hosted)." Updated November 9, 2026. https://onesend.email/research/providers/postal/

Figures on this page are generated from the dataset and copied here unchanged.