Email API

Send Email

POST/api/v1/email/send

Send transactional emails to one or more recipients. Supports HTML content, attachments, and custom headers. Perfect for welcome emails, password resets, notifications, and more.

Requires API key authentication. Include your key in the Authorization header.

Select Language

REQUEST

curl -X POST \
  https://api.sendcomms.com/api/v1/email/send \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "user@example.com",
    "subject": "Welcome to our platform!",
    "html": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "from": "Your App <hello@yourdomain.com>"
  }'

Request Body

Parameter	Type	Required	Description
to	string \| string[]	Required	Recipient email address(es)
subject	string	Required	Email subject line
html	string	Conditional	HTML content (required if no text)
text	string	Conditional	Plain text (required if no html)
from	string	Optional	Sender address
replyTo	string \| string[]	Optional	Reply-to address(es)
cc	string \| string[]	Optional	CC recipients
bcc	string \| string[]	Optional	BCC recipients

Response Codes

200Success400Bad request401Unauthorized402No balance

Response

Success Response

When an email is successfully queued for delivery, you'll receive a response containing the transaction ID and email details.

{
  "success": true,
  "data": {
    "id": "email_abc123xyz",
    "email_id": "re_xxxxxxxxxxxx",
    "status": "sent",
    "recipients": 1,
    "cost": 0.01,
    "currency": "USD"
  }
}

Pricing

$0.001

per email

$0.01

minimum charge

max recipients

Authentication Batch Email