SDK Overview

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 | |----------|---------| | email | 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 | email | | 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://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.