Create an Account

Add Your Sending Domain

Go to Settings → Domains and add the domain you want to send from. Harbur will generate the DNS records you need to add.

Tip

Use a dedicated subdomain such as mail.yourdomain.com for sending. This keeps your root domain reputation separate from your transactional volume.

Generate an API Key

Navigate to Settings → API Keys and click New API Key. Copy the key immediately — it is only shown once.

Send Your First Email

Use the REST API, SMTP relay, or one of the official SDKs to send a test message.

Send via REST API

curl

curl -X POST https://api.harbur.dev/v1/email/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourdomain.com",
    "to": "recipient@example.com",
    "subject": "Hello from Harbur",
    "html": "<p>This is my first email.</p>",
    "text": "This is my first email."
  }'

Send via Node.js SDK

send-email.ts

import { Harbur } from "harbur";

const client = new Harbur(); // Automatically uses process.env.HARBUR_API_KEY

await client.emails.send({
  from:    "support@yourdomain.com",
  to:      "recipient@example.com",
  subject: "Hello from Harbur",
  html:    "<p>This is my first email.</p>",
  text:    "This is my first email.",
});

Send via Python

send_email.py

from harbur import Harbur

client = Harbur(api_key="YOUR_API_KEY")

client.email.send(
    from_address="hello@yourdomain.com",
    to="recipient@example.com",
    subject="Hello from Harbur",
    html="<p>This is my first email.</p>",
    text="This is my first email.",
)

Quickstart Guide

Send via REST API

Send via Node.js SDK

Send via Python