Getting started
Quickstart
Go from a new account to a delivered email in about five minutes: add a domain, publish DNS records, create an API key and send.
You’ll need access to your domain’s DNS settings (at your registrar or DNS host, such as Cloudflare or GoDaddy) and a terminal or code editor.
Create an account
Sign up for a free account. You’ll get a workspace automatically — invite teammates later from Settings → Members. We recommend turning on two-factor authentication straight away.
Add your domain
Open Domains → Add domain and enter the domain you want to send from, for example
acme.com. Use the root domain if you want addresses like[email protected], or a subdomain likemail.acme.comto keep app email separate from your team’s mailboxes.Publish DNS records
Hulaki shows the exact records for your domain. Copy each one into your DNS provider:
Purpose Type Host Required Ownership TXT acme.com Yes DKIM signing TXT hulaki._domainkey.acme.com Yes SPF TXT acme.com Recommended Return-path MX + TXT send.acme.com Recommended DMARC TXT _dmarc.acme.com Recommended We check automatically every few minutes, or click Verify now. Most providers update within minutes; some take up to a few hours. See Sending domains & DNS and the provider guides for details.
Create an API key
Go to Credentials → API keys, create a key with the
emails:sendscope and copy it — it starts withhm_live_and is shown only once. Store it as an environment variable:export HULAKIMAIL_API_KEY="hm_live_..."Never commit API keys to source control or expose them in browser code. Use a send-only key in production.Send an email
Send from any address on your verified domain. Pick your language — or use the SMTP tab if your app already speaks SMTP:
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]>"You’ll get back a
202 Acceptedwith the email’s ID:{ "data": { "id": "msg_01JD3Q8Z4X7M2V9K6T1R5B8N0C", "status": "queued", "to": ["[email protected]"], "created_at": "2026-11-14T09:30:12Z" } }Check the result
Open Emails in the dashboard to see the message move from
queuedtodelivered, or fetch it withGET /api/v1/emails/{id}. To be notified automatically, add a webhook endpoint.
What’s next
- Move your email copy into templates and send with
template_id. - Use
Idempotency-Keyheaders so retries never send twice — see Idempotency. - Read the deliverability checklist before sending at volume.
Something unclear or missing? Tell us.