logo
logo
Developer Hub

Markuzai API & Webhooks

Integrate bulk email and WhatsApp communications directly into your application. Built on REST, JSON, and standard HTTP protocols.

1 Getting Started

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.

API Endpoint: https://api.markuzai.com/v1
BASE URL HTTPS

# API URL

GET https://api.markuzai.com/v1/health

// Success Response

{

"status": "online",

"version": "1.0.0"

}

2 Authentication

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!

REQUEST HEADER BEARER

# Authenticate requests

Authorization: Bearer mk_live_a1b2c3d4...

// Example Curl Request

curl -H "Authorization: Bearer YOUR_KEY" \

https://api.markuzai.com/v1/profile

3 Send Email

Send transactional or marketing emails programmatically. You can pass the recipient details, subject lines, custom templates, or raw HTML content.

POST /v1/emails/send
Body Params:
  • to (string, required) - Recipient email
  • subject (string, required) - Email subject
  • html (string, required) - HTML body content
  • sender_id (string, optional) - Custom SMTP profile ID
CURL REQUEST POST

curl -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"

}

4 Send WhatsApp

Send automated alerts or interactive notifications using Meta-approved WhatsApp Business templates.

POST /v1/whatsapp/send
Body Params:
  • to (string, required) - Phone number in international format
  • template_name (string, required) - Meta Template Name
  • language (string, required) - Code (e.g. 'en')
  • variables (array, optional) - Variable values to inject
CURL REQUEST POST

curl -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"

}

5 Webhooks & Events

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).

PAYLOAD POSTED TO YOUR SERVER EVENT

{

"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..."

}

}

6 Rate Limits

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

Need direct integration support?

Our developer advocates are here to help. Reach out for custom webhook configurations or dedicated setups.

Book a Live Demo

Personalized 15-minute product walkthrough