---
title: "Postal (self-hosted)"
description: "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."
url: https://onesend.email/research/providers/postal/
---
# 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.

<a id="api"></a>
## 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.

<a id="onesend"></a>
## 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](https://onesend.email/docs/providers/).

<a id="sources"></a>
## Sources

Checked November 9, 2026.

- <https://docs.postalserver.io/developer/api>
- <https://docs.postalserver.io/developer/webhooks>
- <https://github.com/postalserver/postal/blob/main/app/controllers/legacy_api/send_controller.rb>
- <https://github.com/postalserver/postal/blob/main/app/controllers/legacy_api/messages_controller.rb>
- <https://github.com/postalserver/postal/blob/main/lib/postal/http.rb>
- <https://github.com/postalserver/postal/blob/main/lib/postal/message_db/delivery.rb>

<a id="citation"></a>
## Suggested citation

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