Integrate bulk email and WhatsApp communications directly into your application. Built on REST, JSON, and standard HTTP protocols.
The Markuzai API provides complete programmatic control over your organizations, workspaces, email dispatches, and WhatsApp template workflows.
Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes.
https://api.markuzai.com/v1
# API URL
GET https://api.markuzai.com/v1/health
// Success Response
{
"status": "online",
"version": "1.0.0"
}
To authenticate API calls, you must include your API key in the Authorization header of all requests. You can generate API keys from the developer settings tab inside the dashboard.
Never share your API key in public repositories or client-side code!
# Authenticate requests
Authorization: Bearer mk_live_a1b2c3d4...
// Example Curl Request
curl -H "Authorization: Bearer YOUR_KEY" \
https://api.markuzai.com/v1/profile
Send transactional or marketing emails programmatically. You can pass the recipient details, subject lines, custom templates, or raw HTML content.
/v1/emails/sendto (string, required) - Recipient emailsubject (string, required) - Email subjecthtml (string, required) - HTML body contentsender_id (string, optional) - Custom SMTP profile IDcurl -X POST https://api.markuzai.com/v1/emails/send \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "client@example.com",
"subject": "Monthly Invoice",
"html": "<h1>Invoice Details...</h1>"
}'
// Success Response (202 Accepted)
{
"success": true,
"message_id": "msg_908a8e8b8c",
"status": "queued"
}
Send automated alerts or interactive notifications using Meta-approved WhatsApp Business templates.
/v1/whatsapp/sendto (string, required) - Phone number in international formattemplate_name (string, required) - Meta Template Namelanguage (string, required) - Code (e.g. 'en')variables (array, optional) - Variable values to injectcurl -X POST https://api.markuzai.com/v1/whatsapp/send \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "+14155552671",
"template_name": "welcome_opt_in",
"language": "en",
"variables": ["John", "MarkuzAI"]
}'
// Success Response (200 OK)
{
"success": true,
"whatsapp_id": "wamid.HBgLMT...",
"status": "delivered"
}
Webhooks allow you to receive real-time notifications about events in your Markuzai accounts.
Configure your webhook URL in the settings to receive payloads when emails are delivered, opened, bounced, or when WhatsApp message statuses update (Read, Unsubscribed).
{
"event": "email.opened",
"created_at": 1780447312,
"data": {
"message_id": "msg_908a8e8b8c",
"recipient": "client@example.com",
"ip_address": "8.8.8.8",
"user_agent": "Mozilla/5.0..."
}
}
We limit the number of API requests you can make to protect the system from abuse and ensure fair resource allocation. Limits are based on your subscription tier:
| Plan Tier | Requests Per Minute | Concurrent Connections |
|---|---|---|
| Starter | 60 requests / min | 2 concurrent |
| Professional | 300 requests / min | 10 concurrent |
| Enterprise | Custom limits (SLA) | Unlimited |
Our developer advocates are here to help. Reach out for custom webhook configurations or dedicated setups.
Personalized 15-minute product walkthrough
Thank you . We have sent a confirmation email to .
One of our specialists will reach out to you within the next 2 hours to confirm your calendar slot.