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. If omitted, uses your verified domain or defaults to info@sendcomms.com. Format: "Name <email@domain.com>" |
| replyTo | string | string[] | Optional | Reply-to address(es) |
| cc | string | string[] | Optional | CC recipients |
| bcc | string | string[] | Optional | BCC recipients |
Response Codes
200Success400Bad request401Unauthorized402No balance429Rate limit exceeded
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
}
}