Skip to main content
POST
/
send
cURL
curl -X POST https://senderr.dev/api/v1/send \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "template_id": "550e8400-e29b-41d4-a716-446655440000",
    "to": ["[email protected]"],
    "subject": "Welcome!",
    "variables": {
      "name": "John Doe"
    }
  }'
{
  "success": true,
  "data": {
    "id": "re_01H123ABC...",
    "from": "[email protected]",
    "to": [
      "[email protected]"
    ],
    "subject": "Welcome to our platform!",
    "sent_at": "2024-01-01T12:00:00Z"
  },
  "meta": {
    "email_usage": {
      "monthly_limit": 1000,
      "current_usage": 45,
      "remaining": 955,
      "plan_type": "monthly",
      "is_overage": false,
      "overage_emails": 0,
      "stripe_usage_reported": false
    }
  }
}

Authorizations

Authorization
string
header
required

Use your API key from the dashboard. Format: Bearer your-api-key-here

Body

application/json
template_id
string<uuid>
required

ID of the template to use for sending the email

to
required

Recipient email address(es)

subject
string
required

Email subject line

cc

CC email address(es)

bcc

BCC email address(es)

reply_to

Reply-to email address(es)

from
string

Sender email address. Can be '[email protected]' or 'Name [email protected]' format. If not provided, uses your verified domain.

variables
object

Variables to use when rendering the template

text
string

Plain text version of the email (optional)

headers
object

Custom headers for the email

attachments
object[]

Email attachments

tags
object[]

Email tags for tracking and organization

scheduled_at
string<date-time>

Schedule email for future delivery (ISO 8601 format)

Response

Email sent successfully

success
boolean
Example:

true

data
object
meta
object