Use this page when you want your website, app, CRM, or checkout system to send email through your approved Bulk Email account. Keep your credentials private and use the exact Sender Name shown in your dashboard.
Send a POST request with JSON data.
sender_name must be the exact Sender Name available in the user Email API page. This keeps the correct sending identity attached to every request.Use the API username, API key, and API secret from the user dashboard. These credentials should stay on your server, not inside public browser code.
| Header | Required | Meaning |
|---|---|---|
X-API-USERNAME | Yes | Your account username. |
X-API-KEY | Yes | Your API key. |
X-API-SECRET | Yes | Your API secret. |
Content-Type | Yes | Use application/json. |
| Field | Required | Use |
|---|---|---|
sender_name | Yes | The exact Sender Name copied from the Email API page. |
email | One recipient option | Use this for one recipient. |
emails | One recipient option | Use an array, comma-separated list, or line-by-line list. |
group_id | One recipient option | Send to a saved contact group. |
subject | Yes | Email subject. |
body | Yes | Email message. It can be plain text or HTML. |
format | No | Use text or html. Default is text. |
reply_to | No | Where replies should go. Leave empty to use the account email. |
Reply-To is optional, but it is useful when you want customer replies to go to a support inbox instead of the sending mailbox.
support@example.com.Copy the example that matches your project.
curl -X POST https://stk-push.top/api/email \
-H 'Content-Type: application/json' \
-H 'X-API-USERNAME: YOUR_USERNAME' \
-H 'X-API-KEY: YOUR_API_KEY' \
-H 'X-API-SECRET: YOUR_API_SECRET' \
-d '{"sender_name":"✨KIRA BULK SMS✨","email":"customer@example.com","subject":"Payment update","body":"Hello customer, your payment has been received.","format":"text","reply_to":"support@example.com"}'<?php
$endpoint = 'https://stk-push.top/api/email';
$payload = [
'sender_name' => '✨KIRA BULK SMS✨',
'email' => 'customer@example.com',
'subject' => 'Payment update',
'body' => 'Hello customer, your payment has been received.',
'format' => 'text',
'reply_to' => 'support@example.com' // optional
];
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-USERNAME: YOUR_USERNAME',
'X-API-KEY: YOUR_API_KEY',
'X-API-SECRET: YOUR_API_SECRET'
],
CURLOPT_POSTFIELDS => json_encode($payload)
]);
$response = curl_exec($ch);
$error = curl_error($ch);
curl_close($ch);
echo $error ? $error : $response;const response = await fetch('https://stk-push.top/api/email', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-USERNAME': 'YOUR_USERNAME',
'X-API-KEY': 'YOUR_API_KEY',
'X-API-SECRET': 'YOUR_API_SECRET'
},
body: JSON.stringify({
sender_name: '✨KIRA BULK SMS✨',
email: 'customer@example.com',
subject: 'Payment update',
body: 'Hello customer, your payment has been received.',
format: 'text',
reply_to: 'support@example.com' // optional
})
});
const data = await response.json();
console.log(data);import requests
url = 'https://stk-push.top/api/email'
headers = {
'Content-Type': 'application/json',
'X-API-USERNAME': 'YOUR_USERNAME',
'X-API-KEY': 'YOUR_API_KEY',
'X-API-SECRET': 'YOUR_API_SECRET'
}
payload = {
'sender_name': '✨KIRA BULK SMS✨',
'email': 'customer@example.com',
'subject': 'Payment update',
'body': 'Hello customer, your payment has been received.',
'format': 'text',
'reply_to': 'support@example.com' # optional
}
r = requests.post(url, json=payload, headers=headers, timeout=30)
print(r.status_code)
print(r.json())Test a real request by entering API credentials, Sender Name, recipient, and optional Reply-To email.
{
"success": true,
"message": "Email API processed",
"job_id": "BEJ123456",
"sent": 1,
"failed": 0,
"charged_units": 1,
"from_name": "✨KIRA BULK SMS✨"
}