MisarMail

Create a new email marketing campaign as a draft. Creating never sends or schedules anything — once the content and audience are confirmed, call send_campaign to send it now or schedule it for later.

create_campaign

Add a single contact. Adding a contact records consent to email them — only add addresses that opted in, or the send will damage sender reputation and may breach CAN-SPAM/GDPR.

create_contact

Create a hosted landing page with a single hero block (headline, subheadline, CTA). Returns the public URL. The real API stores pages as a page-builder block array with no dedicated headline/CTA fields, so this tool translates your inputs into one 'hero' block — for multi-block pages or a real CTA link, use the landing page editor in the MisarMail dashboard.

create_landing_page

Create a reusable email template. Use {{variable}} placeholders for personalisation — they are substituted at send time and previewable via render_template.

create_template

Run a full deliverability audit across authentication (SPF/DKIM/DMARC), domain reputation, list hygiene, content signals, and blocklist status. Returns prioritized findings.

run_deliverability_audit

Get the account deliverability score (0–100) and letter grade (A–F) with the factors dragging it down. Start here when asked why emails are landing in spam.

get_deliverability_score

List submissions for a signup form, including the submitted field values and timestamps.

get_form_submissions

Generate a structured analytics report over a date range. Report types: campaign_performance, engagement_funnel, cohort_analysis, and send_time_heatmap (best hour/day to send).

generate_report

Generate AI subject-line variants for a campaign topic, optionally tuned to a tone and audience. Good input for create_ab_test.

generate_subject_lines

Get delivery and engagement analytics — sent, delivered, opened, clicked, bounced, and complained — for the account or one campaign, grouped by day/week/month.

get_analytics

Get a day/week/month breakdown of sent, delivered, opened, clicked, bounced, complained, replied, and unsubscribed — across every send medium (campaigns, inbox compose, API, MCP, SDKs, GraphQL, automations). The timeline counterpart to get_analytics's period totals.

get_analytics_timeline

Get one automation workflow in full: trigger, every step with its delay, and per-step completion stats.

get_automation

Get full details for one campaign: content, audience segment, schedule, and delivery statistics (sent, opened, clicked, bounced, complained).

get_campaign

Get one signup form including its fields, embed code, and redirect behaviour.

get_form

Get one integration's configuration, scopes, and last sync result.

get_integration

Bulk-import up to 5,000 contacts in one call. By default, addresses that already exist are skipped rather than duplicated — pass update_existing: true to update them instead. Returns per-row results so you can see which rows were rejected and why.

import_contacts

List A/B tests with per-variant results and whether a winner has been selected yet.

list_ab_tests

List API keys on the account with their scopes and last-used time. Key secrets are never returned — only metadata.

list_api_keys

List automation workflows (welcome series, re-engagement, drip sequences) with their trigger type and active state.

list_automations

List email marketing campaigns with their status, audience size, and headline metrics. Filter by status to find drafts ready to send or campaigns still sending.

list_campaigns

List contacts with their subscription status and engagement metrics. Filter by status to find unsubscribed or bounced addresses that should be excluded from sends.

list_contacts

List unified-inbox conversations (threads) with their status and detected intent. Use this for triage; use list_emails for individual messages in a folder.

list_inbox_conversations

List sending domains with verification status and their DKIM/SPF/DMARC records. Check here first when a send fails with an unverified-sender error.

list_domains

List emails from a mailbox folder with optional full-text search across subject and body. Use this for reading the unified inbox; use list_campaigns for marketing sends.

list_emails

List signup forms with their embed status and conversion counts.

list_forms

List connected third-party integrations and their sync status.

list_integrations

List emails captured by sandbox mode. Sandbox intercepts sends instead of delivering them — use it to verify templates and automations without emailing anyone.

list_sandbox_sends

List saved email templates with their variable placeholders, so you can pick one for a campaign or transactional send.

list_templates

Read the full content of a single email by ID, including headers, body, and attachments metadata. Side effect: marks the email as read.

get_email

Render a template with sample variables and return the resulting HTML and subject. Use this to preview personalisation before sending anything.

render_template

Reply to an existing email thread. The sender address and threading headers are derived from the original message, so only the body is required.

reply_to_email

Attribute ecommerce revenue to email — revenue per campaign, per contact, and average order value from tracked conversions.

get_revenue_attribution

Select the winning variant and send it to the remaining audience. This triggers a real send to everyone who was held back — it cannot be undone.

select_ab_test_winner

Send a campaign now, or schedule it for a future time by passing scheduled_at. This delivers real email to real recipients and cannot be undone once sending starts — confirm the audience with get_campaign first.

send_campaign

Send a transactional email from a verified MisarMail account. `from.email` must match an email account you have already verified — use list_domains to check which sender domains are available. Returns the message ID and queue status.

send_email

Activate or pause an automation. Activating starts enrolling contacts and sending on the configured schedule.

toggle_automation

Enable or disable an integration. Disabling stops all syncing but preserves the stored credentials.

toggle_integration

Update an existing contact by email address, including changing subscription status. Setting status to unsubscribed immediately excludes them from every future campaign. Does not support tags, phone, company, or job title — the API has no fields for them.

update_contact

Validate an email address before sending: syntax, MX records, disposable-domain and role-account detection. Use this to protect sender reputation on imported lists.

validate_email

Re-check a domain's DNS records and mark it verified if they resolve. Safe to retry — DNS propagation can take up to 48 hours.

verify_domain