SMTP

​

Settings

​

Before you start

1. A verified domain. The sender address must be on it. See Domains.
2. An API key with the Send Emails permission, used as the password. See API keys. A test key works too: its mail is simulated, not delivered.

​

Examples

import nodemailer from "nodemailer";

const transporter = nodemailer.createTransport({
  host: "smtp.hiveku.com",
  port: 465,
  secure: true,
  auth: { user: "apikey", pass: process.env.HIVEKU_EMAIL_API_KEY },
});

const info = await transporter.sendMail({
  from: "Acme <noreply@mail.acme.com>",
  to: "customer@example.com",
  subject: "Your order shipped",
  text: "On the way. Tracking: ABC123",
  html: "<p>On the way. Tracking: <b>ABC123</b></p>",
});

console.log(info.response); // 250 Message queued: <the email's id>

import os
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "Acme <noreply@mail.acme.com>"
msg["To"] = "customer@example.com"
msg["Subject"] = "Your order shipped"
msg.set_content("On the way. Tracking: ABC123")
msg.add_alternative("<p>On the way. Tracking: <b>ABC123</b></p>", subtype="html")

with smtplib.SMTP_SSL("smtp.hiveku.com", 465) as smtp:
    smtp.login("apikey", os.environ["HIVEKU_EMAIL_API_KEY"])
    smtp.send_message(msg)

SMTP_HOST=smtp.hiveku.com
SMTP_PORT=465
SMTP_SECURE=true
SMTP_USER=apikey
SMTP_PASS=hk_live_...
SMTP_FROM=noreply@mail.acme.com

​

How Hiveku reads a message

• Sign-in. The username must be apikey and the password a key that may send. The key is checked when the client signs in.
• Sender. The envelope sender (MAIL FROM) must be an address on one of your verified domains, or the message is refused. The From header, with its name, is used when it is on a verified domain. Otherwise Hiveku sends from the envelope address, without a name.
• Recipients. The envelope decides who receives the message. Addresses in the To and Cc headers are shown as To and Cc. Every other recipient gets a hidden copy, as Bcc. At most 50 recipients per message.
• Size. At most 25 MB per message, as sent.
• What is kept. Reply-To, attachments (inline images too), and these headers: List-Unsubscribe, List-Unsubscribe-Post, List-Id, In-Reply-To, References, Auto-Submitted, Precedence, and X- headers except reserved ones such as X-Hiveku-. At most 15 headers. Other headers are dropped, and Hiveku sets From, To, Cc and Subject itself.
• Subject. A message without one is sent as “(No Subject)”.
• Tags. SMTP messages carry no tags. Use the REST API if you need them.
• Retries. A client that sends the same message again, byte for byte, after a lost reply gets the first email’s answer. The message goes out once.
• Allowed domains. A key limited to some domains refuses a sender on any other, over SMTP too.

​

Replies

​

Limits