SMTP relay.
A familiar way forward.

Connect in your account’s region.

Port 465 starts inside TLS. Ports 587 and 2525 require STARTTLS before authentication. Keep credentials on your server.

export BIRD_SMTP_HOST=eu1.smtp.bird.com
export BIRD_SMTP_PORT=465
export BIRD_SMTP_TLS_MODE=implicit
export BIRD_SMTP_USER=bird
export BIRD_API_KEY="REPLACE_ON_SERVER"

import nodemailer from "nodemailer";
const port = Number(process.env.BIRD_SMTP_PORT);
const implicit = process.env.BIRD_SMTP_TLS_MODE === "implicit";
if (![465, 587, 2525].includes(port) || implicit !== (port === 465)) {
  throw new Error("TLS mode/port mismatch");
}
const transport = nodemailer.createTransport({
  host: process.env.BIRD_SMTP_HOST, port,
  secure: implicit, requireTLS: !implicit,
  auth: { user: "bird", pass: process.env.BIRD_API_KEY }
});

import os, smtplib, ssl
host = os.environ["BIRD_SMTP_HOST"]
port = int(os.environ["BIRD_SMTP_PORT"])
implicit = os.environ["BIRD_SMTP_TLS_MODE"] == "implicit"
if port not in (465, 587, 2525) or implicit != (port == 465):
    raise ValueError("TLS mode/port mismatch")
context = ssl.create_default_context()
client = (smtplib.SMTP_SSL(host, port, context=context)
          if implicit else smtplib.SMTP(host, port))
try:
    if not implicit:
        client.ehlo()
        client.starttls(context=context)
        client.ehlo()
    client.login("bird", os.environ["BIRD_API_KEY"])
    # Submit your existing MIME message here.
finally:
    client.quit()

These connection excerpts prepare the transport. Use the complete example above to submit a message. Unconfigured SMTP keys use the transactional category; the HTTP API has its own defaults.

1. Authenticate

   Use an API key with emails scope, in the same region as the relay.

2. Queue the MIME message

   Keep the returned email ID with the application event. Preserve the logical idempotency key for an uncertain retry within its supported window.

3. Observe delivery

   Follow recipient events separately. Receiving-server acceptance does not establish inbox placement.