Skip to content

Search documentation

Search pages and sections

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.

  1. 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.

  2. 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 like mail.acme.com to keep app email separate from your team’s mailboxes.

  3. Publish DNS records

    Hulaki shows the exact records for your domain. Copy each one into your DNS provider:

    PurposeTypeHostRequired
    OwnershipTXTacme.comYes
    DKIM signingTXThulaki._domainkey.acme.comYes
    SPFTXTacme.comRecommended
    Return-pathMX + TXTsend.acme.comRecommended
    DMARCTXT_dmarc.acme.comRecommended

    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.

  4. Create an API key

    Go to Credentials → API keys, create a key with the emails:send scope and copy it — it starts with hm_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.
  5. 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>"
      }'

    You’ll get back a 202 Accepted with the email’s ID:

    {
      "data": {
        "id": "msg_01JD3Q8Z4X7M2V9K6T1R5B8N0C",
        "status": "queued",
        "to": ["[email protected]"],
        "created_at": "2026-11-14T09:30:12Z"
      }
    }
  6. Check the result

    Open Emails in the dashboard to see the message move from queued to delivered, or fetch it with GET /api/v1/emails/{id}. To be notified automatically, add a webhook endpoint.

What’s next

Something unclear or missing? Tell us.