Skip to content
Splashify Pro
Email docsEmail

Send email

Send an email to one or more recipients.

POST

/api/v1/partner/email/send

POST/api/v1/partner/email/sendSend an email to one or more recipients.
curl -X POST "https://api.splashifypro.com/api/v1/partner/email/send" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "from": "[email protected]",
  "to": [
    "[email protected]"
  ],
  "subject": "Welcome to our app",
  "html_body": "<h1>Welcome 👋</h1>",
  "text_body": "Welcome."
}'

Request body

A broadcast's from_address follows the same rule as from.

Response

json
{
  "success": true,
  "results": [
    {
      "recipient": "[email protected]",
      "message_id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "queued"
    }
  ]
}

results carries one entry per recipient — to + cc + bcc are flattened.

If a send stops part way, for example the wallet runs out at the 31st recipient, the answer is the error status with results listing the recipients already queued and charged. Retry only the others.

cURL

bash
curl https://api.splashifypro.com/api/v1/partner/email/send \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Welcome",
    "html_body": "<h1>Welcome</h1>",
    "text_body": "Welcome."
  }'

Node

javascript
const res = await fetch(
  "https://api.splashifypro.com/api/v1/partner/email/send",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.SPLASHIFY_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      from: "[email protected]",
      to: ["[email protected]"],
      subject: "Welcome",
      html_body: "<h1>Welcome</h1>",
    }),
  }
);
const data = await res.json();

Python

python
import requests, os
r = requests.post(
    "https://api.splashifypro.com/api/v1/partner/email/send",
    headers={"Authorization": f"Bearer {os.environ['SPLASHIFY_API_KEY']}"},
    json={
        "from": "[email protected]",
        "to": ["[email protected]"],
        "subject": "Welcome",
        "html_body": "<h1>Welcome</h1>",
    },
)

Attachments

/send accepts an attachments[] array of base64-encoded files. PDFs, images, documents, spreadsheets, ZIPs are all supported.

json
{
  "from": "[email protected]",
  "to":   ["[email protected]"],
  "subject":   "Your invoice",
  "html_body": "<p>Invoice attached.</p>",
  "attachments": [
    {
      "filename":       "invoice.pdf",
      "content_type":   "application/pdf",
      "content_base64": "<base64 of file bytes>"
    }
  ]
}

Caps: 20 files, 10 MiB total per message. Executable / script extensions (.exe, .bat, .js, .ps1, .sh, …) are blocked. See Send with attachments for the full reference, inline-image (CID) handling, and per-language code samples.

Common errors