Sending
SMTP relay
Send through Hulaki from any app, CMS or device that speaks SMTP, with the same logs, suppression and tracking as the API.
The SMTP relay accepts mail from your applications and hands it to the same pipeline as the REST API: DKIM signing, suppression checks, tracking, logs and webhooks all apply. Use it when an app already supports SMTP and you don’t want to write code.
Connection settings
| Setting | Value |
|---|---|
| Host | smtp.hulakimail.com |
| Port 587 | STARTTLS (recommended) |
| Port 465 | Implicit TLS (SSL) |
| Port 2525 | STARTTLS — use when your host blocks 587 |
| Authentication | PLAIN or LOGIN |
| Username | Your SMTP credential username (hm_…) |
| Password | The credential’s password |
| Encryption | TLS 1.2 or newer, required before AUTH |
Credentials
Create credentials in Credentials → SMTP. Each one has its own username and a generated password that is shown once — store it in your app’s secret settings. Create a separate credential per application so you can rotate or revoke one without affecting others.
- Allowed From domains: optionally restrict a credential to specific verified domains. Both the envelope sender and the
From:header must match. - Rotate: generate a new password at any time; the old one stops working immediately.
Examples
import nodemailer from 'nodemailer';
const transport = nodemailer.createTransport({
host: 'smtp.hulakimail.com',
port: 587,
secure: false, // STARTTLS is negotiated automatically
requireTLS: true,
auth: { user: process.env.SMTP_USERNAME, pass: process.env.SMTP_PASSWORD },
});
await transport.sendMail({
from: 'Acme <[email protected]>',
to: '[email protected]',
subject: 'Welcome to Acme',
html: '<p>Thanks for signing up!</p>',
});<?php
use PHPMailer\PHPMailer\PHPMailer;
$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.hulakimail.com';
$mail->Port = 587;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth = true;
$mail->Username = getenv('SMTP_USERNAME');
$mail->Password = getenv('SMTP_PASSWORD');
$mail->setFrom('[email protected]', 'Acme');
$mail->addAddress('[email protected]');
$mail->Subject = 'Welcome to Acme';
$mail->isHTML(true);
$mail->Body = '<p>Thanks for signing up!</p>';
$mail->send();# settings.py
EMAIL_BACKEND = "django.core.mail.backends.smtp.EmailBackend"
EMAIL_HOST = "smtp.hulakimail.com"
EMAIL_PORT = 587
EMAIL_USE_TLS = True
EMAIL_HOST_USER = os.environ["SMTP_USERNAME"]
EMAIL_HOST_PASSWORD = os.environ["SMTP_PASSWORD"]
DEFAULT_FROM_EMAIL = "Acme <[email protected]>"# config/environments/production.rb
config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
address: "smtp.hulakimail.com",
port: 587,
user_name: ENV["SMTP_USERNAME"],
password: ENV["SMTP_PASSWORD"],
authentication: :plain,
enable_starttls_auto: true
}swaks --server smtp.hulakimail.com:587 --tls \
--auth PLAIN --auth-user "$SMTP_USERNAME" --auth-password "$SMTP_PASSWORD" \
--from [email protected] --to [email protected] \
--header "Subject: Test from Hulaki" --body "It works!"Limits
| Limit | Value |
|---|---|
| Message size | 30 MB including attachments (advertised via SIZE) |
| Recipients per message | 50 (To + Cc + Bcc) |
| Authentication failures | 5 per IP before a temporary 15-minute block |
| Monthly volume | Shared with the API — see Limits & quotas |
Messages per minute, per credential
| Plan | Messages / minute | Emails / month |
|---|---|---|
| Free | 60 | 3,000 |
| Starter | 600 | 50,000 |
| Pro | 1,500 | 250,000 |
| Business | 3,000 | 1,000,000 |
Reply codes
Temporary (4xx) replies mean “try again later” — well-behaved SMTP clients retry automatically. Permanent (5xx) replies won’t succeed on retry.
| Reply | Meaning |
|---|---|
| 250 2.0.0 | Accepted — the reply includes the message ID |
| 451 4.7.1 | Rate limit reached — slow down |
| 452 4.5.3 | Too many recipients, or monthly quota reached |
| 454 4.7.0 | Authentication temporarily unavailable |
| 530 5.7.0 | Authentication required |
| 535 5.7.8 | Username or password incorrect |
| 550 5.1.1 | Recipient suppressed or invalid |
| 552 5.3.4 | Message too large |
| 553 5.7.1 | From address not allowed — domain not verified or not permitted for this credential |
Troubleshooting
- Connection times out: many hosting providers block outbound port 587 or 465. Try port 2525.
- “Must issue a STARTTLS command first”: enable TLS/STARTTLS in your client before authenticating.
- 553 sender rejected: send from an address on a verified domain, and check the credential’s allowed domains.
openssl s_client -starttls smtp -connect smtp.hulakimail.com:587 -crlf -quietSomething unclear or missing? Tell us.