Quickstart

Getting started with HiSend takes only a few minutes. Follow these steps to prepare your account and send your first email.

1. Create an Account

First, sign up for an account via the HiSend Dashboard.

2. Add and Verify your Domain

To send emails on behalf of your brand, you must verify ownership of your sending domain:

Navigate to Projects -> Domains in the dashboard.
Click Add Domain and enter your domain name (e.g., example.com).
HiSend will generate DNS records (TXT/CNAME) for SPF, DKIM, and DMARC. Add these to your DNS provider (like Cloudflare, Route53, or GoDaddy).
Once the DNS changes propagate, click Verify on the domain page. You will see a verified status once successful.

3. Generate an API Key

API Keys allow your code to securely interact with the HiSend backend.

Navigate to Projects -> API Keys.
Click Create API Key.
Give it a descriptive name and securely copy the generated secret token. You will not be able to see this token again.

4. Send Your First Email

You can interact with HiSend using our REST API or our SDKs. Here is an example of sending a simple email via HTTP cURL:

curl -X POST https://api.hisend.app/v1/emails \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "hello@yourverifieddomain.com",
    "to": ["user@example.com"],
    "subject": "Hello from HiSend!",
    "html": "<html><body><h1>Welcome aboard!</h1><p>This is my first email.</p></body></html>",
    "text": "Welcome aboard! This is my first email."
  }'

If successful, you will receive a 202 Accepted response, and your email will be dispatched immediately!

Explore the Node.js SDK

Learn how to build powerful integrations using TypeScript and Node.js.

API Reference

View the full payload schemas and requirements.