Misar API Reference
REST APIs, authentication guides, webhooks, and error references for every Misar product.
Authentication
All Misar APIs authenticate via API key passed as a Bearer token in the Authorization header.
Authorization Header
Pass your API key as a Bearer token on every request.
Authorization: Bearer msk_your_api_key
Example Request
A typical authenticated cURL call.
curl -X POST https://api.misar.io/mail/v1/send \
-H "Authorization: Bearer msk_key" \
-H "Content-Type: application/json" \
-d '{"to":"[email protected]"}'Key Prefixes by Product
API keys are prefixed per product for easy identification.
msk_Misar Mailmbk_Misar Blogmdk_Misar.Dev
Security Best Practices
Keep your API keys secure and never expose them in client-side code.
- • Store keys in environment variables only
- • Use separate keys per environment
- • Rotate keys immediately if compromised
- • Restrict permissions to required scopes
REST APIs by Product
Select a product to explore its API documentation.
MisarMail
Full-featured email marketing and transactional email platform. Campaign builder, automation workflows, contact segmentation, inbox management, and deep analytics — all self-hosted.
Misar.Blog
Modern blogging platform built for SEO and growth. Clean writing experience, multi-author support, newsletter integration, built-in analytics, and fully self-hostable.
MisarReach
Multi-channel lead generation and outreach platform. Find contacts, build sequences, and automate follow-ups — all in one privacy-first workspace.
Misar.Dev
AI-powered code generation and full-stack development platform for developers. Monaco editor, live preview, Forgejo integration, and one-click deploy — build production apps faster.
MisarPost
Publish and schedule content to every major social network from one dashboard — X/Twitter, LinkedIn, Instagram, Facebook, Threads, YouTube, TikTok. Built for creators and teams who want reach without juggling tabs.
Misar.Ink
A beautiful long-form writing platform for creators and thought leaders. Distraction-free editor, AI writing assistance, and one-click publishing to your audience.
Misar.ai
The flagship Misar AI platform. Chat with state-of-the-art models, build AI agents, and automate workflows — all in one sovereign, privacy-first workspace.
Webhooks
Receive real-time event notifications via HTTP callbacks when events occur in Misar products.
Webhook Payload
Misar sends a signed POST request to your endpoint when an event fires.
POST https://your-app.com/webhooks
X-Misar-Signature: sha256=abc123
{
"event": "email.delivered",
"timestamp": "2025-01-01T00:00:00Z",
"data": { "id": "msg_123" }
}Signature Verification
Always verify the signature to ensure the request came from Misar.
import crypto from "node:crypto";
function verify(body, sig, secret) {
const mac = crypto
.createHmac("sha256", secret)
.update(body).digest("hex");
return `sha256=${mac}` === sig;
}Common Events
Event types vary by product. Examples from Misar Mail:
email.deliveredemail.bouncedemail.openedemail.clicked
Best Practices
Follow these guidelines for reliable webhook handling:
- • Respond with 2xx within 10 seconds
- • Process events asynchronously (use a queue)
- • Handle duplicate events idempotently
- • Always verify the HMAC signature
Need API access or support?
Contact our team for early API access, custom rate limits, or integration help.