Skip to content

Forward a captured message to a real SMTP server​

POST
/api/v1/messages/{id}/release

Disabled unless the server was started with --release-host. The message's raw source is sent unchanged, with the captured envelope (MAIL FROM and RCPT TO), to host over TLS. On port 465 the connection is implicit TLS (SMTPS), TLS from its first byte. On every other allowed port (25, 587, 2525) it starts in plaintext and STARTTLS is required: if the relay does not offer it or the upgrade fails, the message is not sent. Checks run in this order: release enabled, host, configured port, allowed port, message lookup, envelope.

Request Body​

application/json
JSON
{
  
"host": "smtp.mailgun.org",
  
"port": 587
}

Responses​

The relay accepted the message

application/json
JSON
{
  
"released": true
}

Samples​

Powered by VitePress OpenAPI

Released under the MIT / Apache 2.0 License.