Email

Email from your own domain. Sent by your app, read by your team.

The Hostingsurge Email API sends sign-ups, receipts and password resets from your domain over HTTPS or SMTP, signed with DKIM — 100 emails a day on the Free plan. The same domain can hold your team’s mailboxes, in early access.

100 emails a day freeDKIM-signed from your domainHTTPS API and SMTPMailboxes in early accessServers in France
hostingsurge.com/dashboard/email/apiLive demo

Chapter 1 of 5: Add two DNS records and check DNS: sending turns on by itself, with no approval queue.

Example data

Sending that is set up right, from the first email

The parts of transactional email you would otherwise wire together yourself: authentication, keys, limits and a record of what went out.

  • 100 emails a day, free

    The Email API is included on every plan. Free sends up to 100 emails a day and 3,000 a month, counted in recipients. No card and no approval queue.

  • Signed as your domain

    Mail goes out DKIM-signed for the domain you send from. Sending turns on by itself once the verification and DKIM records resolve; SPF and DMARC are checked and explained.

  • One HTTPS request, or SMTP

    POST /api/v1/emails with a Bearer key: from, to, cc, bcc, reply-to, HTML or text, attachments and tags. Apps that only speak SMTP use port 587 with STARTTLS.

  • Keys that can only send

    Sending keys carry email:send and email:read, expire after 7, 30 or 90 days and are shown once. Revoke one app’s key without touching the others.

  • Usage you can see

    Today, the billing period and the hourly burst limit, live in the dashboard, the CLI and MCP. A used-up quota answers 429 with Retry-After; nothing is billed on top.

  • Our own mail servers in France

    Postal sends and mailcow hosts mailboxes, on our servers in the EU — no third-party email service. The send log keeps the sender, a recipient summary and the subject, never the message body.

Recent sends shows whether our mail server accepted each message. Open and click tracking and bounce webhooks are not available yet.

From domain to first email in three steps

The same steps the demo above plays. Nothing to install and no approval to wait for.

  1. Add your domainA domain you own, such as example.com or mail.example.com. One TXT record proves it is yours.
  2. Publish two recordsAdd the verification and DKIM records the dashboard shows. Once they resolve, sending turns on by itself.
  3. Create a key and sendMake a key with email:send, keep it in an environment variable and send with one request.

Send from your code in one request

The same endpoint as the dashboard’s quickstart, which also has Node.js, Python and SMTP versions.

  • The key comes from an environment variable, never from your code
  • HTML or plain text, cc, bcc, reply-to, up to 10 attachments and tags
  • The answer is a message id with the status queued — or 429 with Retry-After when a quota is used up
  • Also from the terminal and AI assistants: hostingsurge email send and the MCP tool email_send
Example: sending an email with cURL
curl -X POST https://hostingsurge.com/api/v1/emails \
  -H "Authorization: Bearer $HOSTINGSURGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@juniperlabs.example",
    "to": ["olivia.park@mail.example"],
    "subject": "Welcome to Juniper",
    "html": "<p>Thanks for signing up.</p>"
  }'

# {"messageId": "48210", "status": "queued"}
Early access

Mailboxes on the same domain

For the people behind the app: hello@, support@ and everyone on the team, on our own mail server.

  • Webmail in the browser, and IMAP, POP3 and SMTP for any mail app
  • Aliases and a catch-all address that forward to one or more mailboxes
  • Spam and virus filtering on incoming mail
  • Import an existing mailbox from your current provider over IMAP
  • Mailboxes and sending are independent: use either, or both on one domain

Mailboxes are in early access: limits and pricing are not set yet.

Mail app settings

  • IMAPmx1.hostingsurge.com · 993 · SSL/TLS
  • SMTPmx1.hostingsurge.com · 587 · STARTTLS
  • POP3mx1.hostingsurge.com · 995 · SSL/TLS
  • Webmailmx1.hostingsurge.com/SOGo

Email API or mailboxes?

Two services on one domain. Each needs its own DNS records and can be turned on without the other.

At a glanceEmail APIMailboxes
ForMail your app sends: sign-ups, receipts, password resetsMail people read and answer: hello@, support@, the team
How you use itHTTPS API with a key, or SMTP relay on port 587Webmail, or IMAP, POP3 and SMTP in any mail app
Mail serverPostal at postal.hostingsurge.commailcow at mx1.hostingsurge.com
DNS it needsVerification and DKIM records; SPF, DMARC and a return path recommendedMX, SPF and DKIM records; DMARC recommended
IncludedOn every plan: Free sends 100 a day and 3,000 a monthEarly access; limits and pricing not set yet

Quotas by plan

Transactional email is included on every plan. Quotas count recipients (to, cc and bcc) and stop at the limit: nothing is billed on top.

  • Free

    For your first idea.3,000 emails a month · up to 25 in an hour

    100 emails a day

  • Pro

    For builders shipping continuously.50,000 emails a month · up to 2,500 in an hour

    10,000 emails a day

  • Business

    For teams and agencies.100,000 emails a month · up to 5,000 in an hour

    20,000 emails a day

Every account runs on Free today: paid checkout is not open yet. Compare plans

Email questions

Is the Email API really free?

Yes, on every plan. Free includes 100 emails a day and 3,000 a month, counted in recipients (to, cc and bcc). No card needed.

What do I need to start sending?

A domain you own. Add it, publish its verification and DKIM records, and sending turns on by itself once the DNS check passes — no approval and no waiting list. Then create an API key.

What happens when I reach a quota?

New sends through the API are refused with 429 and a Retry-After header until the day (UTC) or the billing period starts over. Nothing is billed on top. SMTP messages sent while a quota is used up are held by the mail server and not delivered.

Can I send over SMTP?

Yes: postal.hostingsurge.com, port 587 with STARTTLS. The SMTP password is shown once, and a new one replaces the old. SMTP sends count toward the same quotas.

Do you track opens, clicks or bounces?

Not yet. Recent sends lists every API send and whether our mail server accepted it, and a message’s delivery attempts can be read through the API. Open and click tracking and bounce webhooks are not available.

Are mailboxes available?

In early access: webmail, IMAP, POP3 and SMTP, aliases and a catch-all, spam and virus filtering, and import from your old provider over IMAP. Limits and pricing are not set yet.

Can I move my existing email?

Yes. IMAP import copies an existing mailbox from your current provider into a new mailbox here. Your old provider keeps receiving mail until you change the domain’s MX record.

Where is my email handled?

On our own mail servers in France (EU): Postal for sending and mailcow for mailboxes, with no third-party email service. The send log keeps the sender, a recipient summary and the subject, never the message body.

Send your first email today.

Free includes 100 emails a day. No card needed — add your domain and create a key.