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.