SDKs
SDK Overview
Choose the right MisarMail SDK for your language
What is the MisarMail SDK?
The MisarMail SDK wraps the mail.misar.io/api/v1 REST API. All SDKs expose the complete API surface — 24 resource groups and ~101 methods.
| Resource | Methods |
|---|---|
| send | |
| contacts | list, create, get, update, delete, import |
| campaigns | list, create, get, update, send, delete |
| templates | list, create, get, update, delete, render |
| automations | list, create, get, update, delete, activate |
| domains | list, create, get, verify, delete |
| aliases | list, create, get, update, delete |
| dedicatedIps | list, create, update, delete |
| channels | sendWhatsapp, sendPush |
| abTests | list, create, get, setWinner |
| sandbox | send, list, delete |
| inbound | list, create, get, delete |
| analytics | overview |
| track | event, purchase |
| keys | list, create, get, revoke |
| validate | |
| leads | search, getJob, listJobs, results, importLeads, credits |
| autopilot | start, get, list, dailyPlan |
| salesAgent | getConfig, updateConfig, getActions |
| crm | listConversations, getConversation, updateConversation, listMessages, listDeals, createDeal, getDeal, updateDeal, deleteDeal, listClients, createClient |
| webhooks | list, create, get, update, delete, test |
| usage | get |
| billing | subscription, checkout |
| workspaces | list, create, get, update, delete, listMembers, inviteMember, updateMember, removeMember |
Available SDKs
| Language | Package | Source |
|---|---|---|
| TypeScript / JavaScript | @misarmail/sdk | misarmail-sdks/typescript |
| Python | misarmail | misarmail-sdks/python |
| Go | github.com/Misar-AI/misarmail-sdks/go | misarmail-sdks/go |
| PHP | misarai/misarmail-php | misarmail-sdks/php |
| Ruby | misarmail gem | misarmail-sdks/ruby |
| Rust | misarmail crate | misarmail-sdks/rust |
| Dart | misarmail pub package | misarmail-sdks/dart |
| Flutter | misar_mail_flutter pub package | misarmail-sdks/flutter |
| Kotlin | io.misar:misarmail-kotlin | misarmail-sdks/kotlin |
| Java | io.misar:misarmail-java | misarmail-sdks/java |
| Swift | MisarMail SPM package | misarmail-sdks/swift |
| C# | Misar.Mail NuGet | misarmail-sdks/csharp |
Authentication
All SDKs authenticate with a msk_... API key via the Authorization: Bearer header.
curl -X POST https://mail.misar.io/api/v1/send \
-H "Authorization: Bearer msk_your_key" \
-H "Content-Type: application/json" \
-d '{"from":{"email":"hello@misar.io"},"to":[{"email":"user@example.com"}],"subject":"Hi","text":"Hello"}'Rate Limits
| Plan | Sends/month | Rate |
|---|---|---|
| Free | 3,000 | 10/s |
| Pro | 100,000 | 100/s |
| Scale | Unlimited | 500/s |
Responses include X-RateLimit-Remaining and X-RateLimit-Reset headers.