hulakimail.com/app/acme/emails
メール
過去7日間 · acme.com
送信済み
48,210
配信済み
99.2%
開封
41.8%
バウンス
0.4%
宛先件名ステータス送信元日時
REST APIとSDK
送信はリクエスト1回。問題があれば、明確な答えを。
BearerキーでJSONを/api/v1/emailsにPOSTするだけ。すぐにIDが返り、エラーはすべて同じ形式(タイプ、メッセージ、コード、問題のあるパラメーター)で返されます。
- Node.js(@hulakimail/node)とPHP(hulakimail/hulakimail-php)の公式SDK
- Idempotency-Keyヘッダーで、再試行しても二重送信なし
- 1リクエストで最大100通を送れる一括送信エンドポイント
- プランごとのレート制限と、標準のRetry-Afterヘッダー
POST /emails
curl https://hulakimail.com/api/v1/emails \
-H "Authorization: Bearer $HULAKIMAIL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "Acme <[email protected]>",
"to": ["[email protected]"],
"subject": "Welcome to Acme",
"html": "<p>Thanks for signing up, Ada!</p>"
}'import { HulakiMail } from '@hulakimail/node';
const hulakimail = new HulakiMail(process.env.HULAKIMAIL_API_KEY);
const { id } = await hulakimail.emails.send({
from: 'Acme <[email protected]>',
to: ['[email protected]'],
subject: 'Welcome to Acme',
html: '<p>Thanks for signing up, Ada!</p>',
});<?php
use HulakiMail\HulakiMail;
$hulakimail = new HulakiMail(getenv('HULAKIMAIL_API_KEY'));
$email = $hulakimail->emails->send([
'from' => 'Acme <[email protected]>',
'to' => ['[email protected]'],
'subject' => 'Welcome to Acme',
'html' => '<p>Thanks for signing up, Ada!</p>',
]);import os
import requests
response = requests.post(
"https://hulakimail.com/api/v1/emails",
headers={"Authorization": f"Bearer {os.environ['HULAKIMAIL_API_KEY']}"},
json={
"from": "Acme <[email protected]>",
"to": ["[email protected]"],
"subject": "Welcome to Acme",
"html": "<p>Thanks for signing up, Ada!</p>",
},
)
print(response.json()["data"]["id"])// .env
// MAIL_MAILER=hulakimail
// HULAKIMAIL_API_KEY=hm_live_...
use App\Mail\WelcomeMail;
use Illuminate\Support\Facades\Mail;
Mail::to('[email protected]')->send(new WelcomeMail($user));# Any framework, CMS or device that speaks SMTP
SMTP_HOST=smtp.hulakimail.com
SMTP_PORT=587 # STARTTLS · or 465 (TLS) · 2525 (fallback)
SMTP_USERNAME=hm_smtp_7f3a9c
SMTP_PASSWORD=your-smtp-password
SMTP_FROM="Acme <[email protected]>"SMTPリレー
コード不要。どんなアプリもSMTPリレーにつなぐだけ。
WordPress、Magento、Ghost、ヘルプデスク、ネットワークプリンターまで。SMTPで送信できるものなら、Hulakiから送信でき、APIと同じログ、配信停止、トラッキングが使えます。
- STARTTLSはポート587と2525、暗黙的TLSはポート465
- アプリごとに個別の認証情報。ひとつを無効にしても他には影響しません
- 各認証情報で使える送信ドメインを限定可能
SMTP設定
Host smtp.hulakimail.com
Port 587 (STARTTLS) · 465 (TLS) · 2525 (alternate)
Username your SMTP credential username
Password shown once when you create the credential
From any address on a verified domain配信ログ
すべてのメッセージの行方がわかる
宛先、件名、タグ、ステータスで検索できます。メールを開けば、受付、送信、配信、開封、クリック、バウンスまでのタイムラインと、相手サーバーからの正確な応答を確認できます。
- ステータス、ドメイン、タグ、APIキー、SMTP認証情報で絞り込み
- レンダリング済みのプレビューと生のヘッダー
- プランに応じて3〜365日間保存
領収書 #4821
msg_01JD3Q8Z4X7M2V9K6T1R5B8N0C
- email.queued09:30:12.041
API経由で受付 · Idempotency-Key order_4821
- email.sent09:30:12.388
配信ネットワークへ引き渡し · TLS 1.3
- email.delivered09:30:13.902
250 2.0.0 OK — gmail-smtp-in.l.google.com
- email.opened09:34:51
Apple Mail · プライバシー保護あり
- email.clicked09:35:07
acme.com/orders/4821
Webhook
配信、バウンス、クリックにリアルタイムで対応
必要なイベントだけをHTTPSエンドポイントで受信できます。すべてのリクエストにはHulakiMail-Signatureヘッダーで署名が付き、サーバーが200を返すまでバックオフ付きで再試行されます。
- イベント:email.sent, delivered, delayed, bounced, complained, opened, clicked
- リプレイ攻撃を防ぐタイムスタンプ付きのHMAC-SHA256署名
- 配信の試行と応答をダッシュボードで確認
email.bounced
{
"id": "evt_01JD3QB2M8T6W1Z4R9K7P3N5XC",
"type": "email.bounced",
"created_at": "2026-11-14T09:30:14Z",
"data": {
"email_id": "msg_01JD3Q8Z4X7M2V9K6T1R5B8N0C",
"recipient": "[email protected]",
"bounce": { "type": "permanent", "diagnostic": "550 5.1.1 user unknown" },
"tags": ["digest"]
}
}テンプレート
文面をコードベースから切り離す
テンプレートをHulakiに保存し、IDと変数を指定して送信できます。マーケティング担当者はデプロイなしで誤字を直せ、開発者は安定したインターフェースを保てます。
- {{variables}}、{{#if}}、{{#each}}、{{{raw}}} HTML
- サンプルデータによるライブプレビュー
- プレーンテキスト版は自動生成も手書きも可能
order-confirmation.html
<h1>Thanks for your order, {{customer.first_name}}!</h1>
{{#each items}}
<p>{{quantity}} × {{name}} — {{price}}</p>
{{/each}}
{{#if tracking_url}}
<a href="{{tracking_url}}">Track your parcel</a>
{{/if}}独自ドメイン
初日から認証済み
ドメインを追加し、DNSレコードをプロバイダーにコピーすれば、自動で認証します。メールにはDKIM署名が付き、DMARCのアライメントにも対応。バウンスは所有するサブドメインに返ってきます。
- SPF、DKIM、DMARC、カスタムReturn-Path
- ブランド名入りのクリックトラッキング用サブドメイン
- Cloudflare、GoDaddy、Namecheapなどの設定ガイド
hulakimail.com/app/acme/domains/acme.com
acme.com
これらのレコードをDNSプロバイダーに追加してください。確認は自動で行います。
タイプ名前値ステータス
TXT@v=spf1 include:spf.hulakimail.com ~allSPF
CNAMEhm1._domainkeyhm1.dkim.hulakimail.comDKIM
CNAMEhm2._domainkeyhm2.dkim.hulakimail.comDKIM
MXbounce10 feedback.hulakimail.comReturn-Path
TXT_dmarcv=DMARC1; p=quarantine; rua=mailto:…DMARC
CNAMElinkstrack.hulakimail.com確認中
その他の機能
本番環境のメール配信に必要なすべてを
冪等なリクエスト
同じIdempotency-Keyで2回送信しても、返るのは最初の応答。メールが重複することはありません。
一括送信
1回のAPI呼び出しで、パーソナライズしたメールを最大100通まとめて送信できます。
予約送信
scheduled_atを設定すれば後から送信。送信前ならキャンセルも可能です。
添付ファイル
PDFの請求書、カレンダーの招待、インライン画像をcontent_idで添付できます。
タグとメタデータ
絞り込み用にメッセージにラベルを付けられ、メタデータはすべてのWebhookで返されます。
開封・クリックのトラッキング
メッセージごとに有効化でき、ブランド独自のトラッキング用ドメインで計測します。
配信停止リスト
バウンス、苦情、配信停止のあったアドレスは自動でスキップされます。
スコープ付きAPIキー
本番環境には送信専用、ダッシュボードには読み取り専用、管理スクリプトにはフルアクセスのキーを。
予測しやすいエラー
すべてのエラーに、タイプ、人が読めるメッセージ、機械向けのコード、原因となったパラメーターが含まれます。