Sdks
C# SDK
Install and use the MisarMail C# SDK
Installation
dotnet add package Misar.MailOr via the NuGet Package Manager:
Install-Package Misar.Mail
Quick Start
using Misar.Mail;
using Misar.Mail.Models;
var client = new MisarMailClient(Environment.GetEnvironmentVariable("MISARMAIL_API_KEY")!);
var result = await client.SendAsync(new SendRequest
{
From = new Address { Email = "[email protected]", Name = "Misar" },
To = [new Address { Email = "[email protected]" }],
Subject = "Welcome",
Html = "<p>Hello from MisarMail!</p>",
});
Console.WriteLine($"Sent: {result.MessageId}");
Available Methods
All async methods accept an optional CancellationToken ct parameter.
| Method | Description |
|---|---|
client.SendAsync(request, ct) | Send a transactional email |
client.Contacts.ListAsync(params, ct) | List contacts |
client.Contacts.CreateAsync(request, ct) | Create a contact |
client.Contacts.GetAsync(id, ct) | Get a contact |
client.Contacts.UpdateAsync(id, request, ct) | Update a contact |
client.Contacts.DeleteAsync(id, ct) | Delete a contact |
client.Contacts.ImportAsync(request, ct) | Bulk import contacts |
client.Campaigns.ListAsync(params, ct) | List campaigns |
client.Campaigns.CreateAsync(request, ct) | Create a campaign |
client.Campaigns.GetAsync(id, ct) | Get a campaign |
client.Campaigns.UpdateAsync(id, request, ct) | Update a campaign |
client.Campaigns.SendAsync(id, ct) | Send/schedule a campaign |
client.Campaigns.DeleteAsync(id, ct) | Delete a campaign |
client.Templates.ListAsync(params, ct) | List templates |
client.Templates.CreateAsync(request, ct) | Create a template |
client.Templates.GetAsync(id, ct) | Get a template |
client.Templates.UpdateAsync(id, request, ct) | Update a template |
client.Templates.DeleteAsync(id, ct) | Delete a template |
client.Templates.RenderAsync(id, request, ct) | Render a template with merge data |
client.Automations.ListAsync(params, ct) | List automations |
client.Automations.CreateAsync(request, ct) | Create an automation |
client.Automations.GetAsync(id, ct) | Get an automation |
client.Automations.UpdateAsync(id, request, ct) | Update an automation |
client.Automations.DeleteAsync(id, ct) | Delete an automation |
client.Automations.ActivateAsync(id, ct) | Activate/deactivate an automation |
client.Domains.ListAsync(ct) | List sending domains |
client.Domains.CreateAsync(request, ct) | Add a sending domain |
client.Domains.GetAsync(id, ct) | Get a domain |
client.Domains.VerifyAsync(id, ct) | Trigger domain DNS verification |
client.Domains.DeleteAsync(id, ct) | Delete a domain |
client.Aliases.ListAsync(params, ct) | List email aliases |
client.Aliases.CreateAsync(request, ct) | Create an alias |
client.Aliases.GetAsync(id, ct) | Get an alias |
client.Aliases.UpdateAsync(id, request, ct) | Update an alias |
client.Aliases.DeleteAsync(id, ct) | Delete an alias |
client.DedicatedIPs.ListAsync(ct) | List dedicated IPs |
client.DedicatedIPs.CreateAsync(request, ct) | Purchase a dedicated IP |
client.DedicatedIPs.UpdateAsync(id, request, ct) | Update IP pool assignment |
client.DedicatedIPs.DeleteAsync(id, ct) | Release a dedicated IP |
client.ABTests.ListAsync(params, ct) | List A/B tests |
client.ABTests.CreateAsync(request, ct) | Create an A/B test |
client.ABTests.GetAsync(id, ct) | Get an A/B test |
client.ABTests.SetWinnerAsync(id, variant, ct) | Manually set the winning variant |
client.Sandbox.SendAsync(request, ct) | Send in sandbox mode |
client.Sandbox.ListAsync(params, ct) | List sandbox messages |
client.Sandbox.DeleteAsync(id, ct) | Delete a sandbox message |
client.Inbound.ListAsync(params, ct) | List inbound routing rules |
client.Inbound.CreateAsync(request, ct) | Create an inbound route |
client.Inbound.GetAsync(id, ct) | Get an inbound route |
client.Inbound.DeleteAsync(id, ct) | Delete an inbound route |
client.Analytics.OverviewAsync(params, ct) | Get send/open/click/bounce analytics |
client.Track.EventAsync(request, ct) | Track a custom event |
client.Track.PurchaseAsync(request, ct) | Track a purchase event |
client.Keys.ListAsync(ct) | List API keys |
client.Keys.CreateAsync(request, ct) | Create an API key |
client.Keys.GetAsync(id, ct) | Get an API key |
client.Keys.RevokeAsync(id, ct) | Revoke an API key |
client.Validate.EmailAsync(address, ct) | Validate an email address |
client.Webhooks.ListAsync(params, ct) | List webhooks |
client.Webhooks.CreateAsync(request, ct) | Create a webhook endpoint |
client.Webhooks.GetAsync(id, ct) | Get a webhook |
client.Webhooks.UpdateAsync(id, request, ct) | Update a webhook |
client.Webhooks.DeleteAsync(id, ct) | Delete a webhook |
client.Webhooks.TestAsync(id, ct) | Send a test event to a webhook |
client.Usage.GetAsync(params, ct) | Get API usage stats |
client.Billing.SubscriptionAsync(ct) | Get current subscription details |
client.Billing.CheckoutAsync(request, ct) | Create a billing checkout session |
client.Workspaces.ListAsync(ct) | List workspaces |
client.Workspaces.CreateAsync(request, ct) | Create a workspace |
client.Workspaces.GetAsync(id, ct) | Get a workspace |
client.Workspaces.UpdateAsync(id, request, ct) | Update a workspace |
client.Workspaces.DeleteAsync(id, ct) | Delete a workspace |
client.Workspaces.ListMembersAsync(id, ct) | List workspace members |
client.Workspaces.InviteMemberAsync(id, request, ct) | Invite a member to workspace |
client.Workspaces.UpdateMemberAsync(id, userId, request, ct) | Update member role |
client.Workspaces.RemoveMemberAsync(id, userId, ct) | Remove a member from workspace |
Examples
Webhooks
var webhook = await client.Webhooks.CreateAsync(new CreateWebhookRequest
{
Url = "https://yourapp.com/webhooks/mail",
Events = ["email.delivered", "email.opened", "email.bounced"],
});
await client.Webhooks.TestAsync(webhook.Id);
Error Handling
try
{
await client.SendAsync(request);
}
catch (MisarMailApiException ex)
{
Console.Error.WriteLine($"{ex.StatusCode}: {ex.Message}");
}