Quick Start

Send your first email in 5 minutes with HeliosSend.

Step 1: Get Your API Key

API Key

You need your API Key from your HeliosSend dashboard.

Log in to your HeliosSend dashboard
Navigate to the API Keys section
Copy your API Key (starts with cs_)

Step 2: Send Your First Email

Send Email Request

Using cURL

curl -X POST "https://client.heliossend.com/send" \
  -H "Content-Type: application/json" \
  -H "Authorization: cs_YOUR_API_KEY" \
  -d '{
    "from": "sender@yourdomain.com",
    "to": ["recipient@example.com"],
    "subject": "Hello from HeliosSend!",
    "html": "<h1>Hello!</h1><p>This is my first email.</p>"
  }'

Using Python

import requests

url = "https://client.heliossend.com/send"
headers = {
    "Content-Type": "application/json",
    "Authorization": "cs_YOUR_API_KEY"
}
payload = {
    "from": "sender@yourdomain.com",
    "to": ["recipient@example.com"],
    "subject": "Hello from HeliosSend!",
    "html": "<h1>Hello!</h1><p>This is my first email.</p>"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

Step 3: Check Status

Verify Email Sent

After sending, you'll receive a response with a message_id:

{
  "message_id": "msg_abc123xyz",
  "status": "sent"
}

Check the status of your message:

curl https://client.heliossend.com/status/msg_abc123xyz

Important Notes

Before You Send

The from email address or domain must be verified in your HeliosSend dashboard
Verify your domain in Dashboard → Domains before sending emails
Keep your API Key secure and never expose it in client-side code
Use environment variables to store sensitive credentials
Include your API Key in the Authorization header

Next Steps

Now that you've sent your first email, explore the full documentation: