Email API

Batch Send

POST/api/v1/email/batch

Send multiple emails in a single API request. Perfect for newsletters, marketing campaigns, and bulk notifications. Supports up to 100 emails per batch with individual customization.

Maximum 100 emails per batch. Each email can have up to 50 recipients.

Select Language

REQUEST

curl -X POST \
  https://api.sendcomms.com/v1/email/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "emails": [
      {
        "to": "user1@example.com",
        "subject": "Welcome!",
        "html": "<h1>Welcome User 1!</h1>"
      },
      {
        "to": "user2@example.com",
        "subject": "Welcome!",
        "html": "<h1>Welcome User 2!</h1>"
      },
      {
        "to": ["user3@example.com", "user4@example.com"],
        "subject": "Team Update",
        "html": "<p>Important team update...</p>"
      }
    ]
  }'

Request Body

Parameter	Type	Required	Description
emails	array	Required	Array of email objects (max 100)
emails[].to	string \| string[]	Required	Recipient email(s)
emails[].subject	string	Required	Email subject line
emails[].html	string	Conditional	HTML content (required if no text)
emails[].text	string	Conditional	Plain text content (required if no html)
emails[].from	string	Optional	Sender address (default: verified domain)

Response

Success Response

{
  "success": true,
  "data": {
    "batch_id": "batch_abc123xyz",
    "status": "sent",
    "emails_sent": 3,
    "total_recipients": 4,
    "cost": 0.04,
    "currency": "USD",
    "results": {
      "data": [
        { "id": "email_001" },
        { "id": "email_002" },
        { "id": "email_003" }
      ]
    }
  }
}

Pricing

$0.001

per recipient

$0.01

minimum per email

100

max emails per batch

Send Email Webhooks