Send your first email

Mailhuset sends transactional and broadcast email over a simple REST API (and SMTP), with the deliverability plumbing (SPF, DKIM, DMARC, bounce and complaint handling) managed for you. Here's zero to a delivered email.

1. Verify a sending domain

You send *from* a domain you own, and it has to be authenticated so mailbox providers trust it. Add your domain and publish the DNS records Mailhuset gives you. See Verify a sending domain.

2. Create an API key

Open API keys → Create key and copy it once (it's shown a single time). Keep it in a secret store, never in source. See API keys.

3. Send

curl -X POST https://api.mailhuset.com/v1/email \
  -H "Authorization: Bearer $MAILHUSET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "You <hello@yourdomain.com>",
    "to": ["customer@example.com"],
    "subject": "Welcome to Acme",
    "html": "<h1>Welcome</h1><p>Glad you are here.</p>"
  }'

A 2xx returns a message id. Prefer a library? See the Node & Python SDKs.

4. Watch it deliver

Open Activity to see the message move through accepted → sent → delivered (and opened/clicked if you enabled tracking). For programmatic updates, add a webhook.

Next steps

• Send email via the API: every field explained.
• Deliverability best practices: land in the inbox.
• Webhooks: get delivery, bounce, and open events.
• API reference and the Node & Python SDKs.

Need help? Email support@mailhuset.com.