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 — 40+ 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 | subjectLines |
| 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 |
| notifications | list, markRead |
| preferences | get, update |
| settings | getAuditLog, getIpPools, getSignatures, createSignature, deleteSignature, getSmtpPools, testSmtpPool, getWhitelabel, updateWhitelabel |
| deliverability | getScore, getRecommendations |
| integrations | list, get, toggle |
| inbox | list, get, markRead, delete, sync |
| drafts | list, create, update, delete |
| wallet | get, debit, credit |
| subscription | get, planLimits, upsert, cancel |
| teamMembers | get |
| creditRates | list |
| emailAccounts | list |
Available SDKs
| Language | Package | Source |
|---|---|---|
| TypeScript / JavaScript | @misarmail/sdk | misarmail-sdks/typescript |
| Python | misarmail | misarmail-sdks/python |
| Go | github.com/misarai/misarmail-go | misarmail-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":"hello@misar.io"},"to":[{"email":"user@example.com"}],"subject":"Hi","text":"Hello"}'Rate Limits
Sending volume is governed by your plan's daily and monthly caps:
| Plan | Emails/day | Emails/month |
|---|---|---|
| Free | 100 | 3,000 |
| Pro | 10,000 | 300,000 |
| Max | 50,000 | 1,500,000 |
| Enterprise | Custom | Unlimited |
Responses include X-RateLimit-Remaining and X-RateLimit-Reset headers.