Sdks
SDK Overview
Choose the right MisarMail SDK for your language
What is the MisarMail SDK?
The MisarMail SDK wraps the api.misar.io/mail/v1 REST API. All SDKs expose the complete API surface — 35 resource groups and ~150+ methods.
| Resource | Key Methods |
|---|---|
send | |
| contacts | list, create, get, update, delete, import |
| campaigns | list, create, get, update, send, delete, getSends, createAbTest, optimize, predict, rewrite, saveAsTemplate, setReplyWebhook |
| templates | list, create, get, update, delete, render |
| automations | list, create, get, update, delete, activate |
| segments | list, create, get, update, delete, preview, refresh |
| forms | list, create, get, update, delete, getSubmissions |
| labels | list, create, delete |
| landingPages | list, create, get, update, delete |
| domains | list, create, get, verify, delete |
| dmarc | list, addDomain, deleteDomain |
| aliases | list, create, get, update, delete |
| dedicatedIps | list, create, update, delete |
| abTests | list, create, get, setWinner |
| sandbox | send, list, delete |
| inbound | list, create, get, delete |
| analytics | overview, campaign, benchmark, churnRisk, cohorts, export, insights, reports, revenue |
| track | event, purchase |
| ai | generateSubjectLines, generateEmail, suggestReply, buildSegment |
| keys | list, create, get, revoke |
| validate | email |
| webhooks | list, create, get, update, delete, test |
| usage | get |
| billing | subscription, checkout, portal, plans, wallet |
| workspaces | list, create, get, update, delete, listMembers, inviteMember, updateMember, removeMember |
| referrals | getStats, generate, claim, leaderboard, milestones, logShare |
| monetization | listSponsors, createSponsor, listSubscriptions, createSubscription, recordTip |
| marketplace | list, get, getMine, purchase, download, review, submit |
| oauth | registerClient, authorize, token, revoke |
| notifications | list, markRead |
| preferences | get, update |
| settings | getAuditLog, getIpPools, getSignatures, createSignature, deleteSignature, getSmtpPools, testSmtpPool, getWhitelabel, updateWhitelabel |
| warmup | getReport, initialize, pause, resume, delete |
| deliverability | getScore, getRecommendations |
| integrations | list, get, toggle |
| inbox | list, get, markRead, delete, sync |
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://api.misar.io/mail/v1/send \
-H "Authorization: Bearer msk_your_key" \
-H "Content-Type: application/json" \
-d '{"from":{"email":"[email protected]"},"to":[{"email":"[email protected]"}],"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.