Send Email

POST /api/v1/send

Quick Start

Send Transactional Emails

Add email sending capability to your application

Ready-to-use instructions for AI coding assistants

Click to view full instructions

Authentication

Include your API key in the Authorization header:

Authorization: Bearer sk_live_YOUR_API_KEY

Request Body

Parameter	Type	Required	Description
to	string[]	Yes	Recipient email addresses (max 50)
subject	string	Yes	Email subject line
html	string	*	HTML body (* html or text required)
text	string	*	Plain text body (* html or text required)
from	object	No	Sender details (uses default if omitted)
from.email	string	No	Sender email (must be verified domain)
from.name	string	No	Sender display name
cc	string[]	No	CC recipients
bcc	string[]	No	BCC recipients
replyTo	string	No	Reply-to email address
attachments	object[]	No	File attachments (max 40MB total)

Attachments

Each attachment object has the following properties:

Property	Type	Description
filename	string	File name (e.g., "invoice.pdf")
contentType	string	MIME type (e.g., "application/pdf")
content	string	Base64-encoded file content

Limits: 10MB per file, 40MB total per email.

curl -X POST https://tigermail.io/api/v1/send \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["user@example.com"],
    "subject": "Your Invoice",
    "html": "<p>Please see the attached invoice.</p>",
    "attachments": [
      {
        "filename": "invoice.pdf",
        "contentType": "application/pdf",
        "content": "JVBERi0xLjQK..."
      }
    ]
  }'

Response

Success (200)

{
  "success": true,
  "id": "clx1234567890",
  "messageId": "0100018f-1234-5678-9abc-def012345678"
}

Errors

Status	Description
400	Validation failed or invalid domain
401	Invalid or missing API key
403	API key lacks 'send' permission
429	Rate limit or usage limit exceeded
500	Failed to send email

Rate Limits

Default: 100 requests per minute per API key. Contact support for higher limits.