Browse, purchase, and submit email templates and add-ons in the MisarMail marketplace

Overview

The MisarMail Marketplace is a catalog of community and officially-created assets that extend your email workflows:

Category	Description
`template`	Pre-designed email templates (drag-and-drop and HTML)
`integration`	Connectors to third-party services (CRMs, analytics, payment processors)
`addon`	Functional add-ons such as countdown timers, poll blocks, and referral widgets

Public browsing (list and detail endpoints) requires no authentication. Purchasing, downloading, reviewing, and submitting require a session.

List Marketplace Items

Browse all available items with optional filtering and search.

GET /v1/marketplace

Query parameters

Parameter	Type	Description
`category`	string	Filter by `template`, `integration`, or `addon`
`search`	string	Full-text search across title, description, and tags
`page`	integer	Page number (default: 1)
`limit`	integer	Items per page (default: 20, max: 100)

Response

{
  "items": [
    {
      "id": "mkt_01jabcdef",
      "title": "Minimal Weekly Digest",
      "description": "A clean, single-column digest template with section separators and a CTA block.",
      "category": "template",
      "price_cents": 0,
      "author": "MisarMail Team",
      "preview_url": "https://cdn.misarmail.com/marketplace/mkt_01jabcdef/preview.png",
      "rating": 4.8,
      "review_count": 132,
      "tags": ["minimal", "digest", "weekly", "newsletter"]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 87,
    "pages": 5
  }
}

Items with price_cents: 0 are free.

Get Item Details

Fetches full details for a single item, including extended description and full-size preview.

GET /v1/marketplace/:id

Response

{
  "id": "mkt_01jabcdef",
  "title": "Minimal Weekly Digest",
  "description": "A clean, single-column digest template...",
  "long_description": "Full HTML description with usage guide...",
  "category": "template",
  "price_cents": 0,
  "author": "MisarMail Team",
  "preview_url": "https://cdn.misarmail.com/marketplace/mkt_01jabcdef/preview.png",
  "full_preview_url": "https://cdn.misarmail.com/marketplace/mkt_01jabcdef/full.png",
  "rating": 4.8,
  "review_count": 132,
  "tags": ["minimal", "digest", "weekly"],
  "created_at": "2025-09-01T00:00:00Z",
  "updated_at": "2025-10-15T00:00:00Z"
}

My Purchased Items

Returns all marketplace items purchased by the authenticated user.

GET /v1/marketplace/my

Auth: Session required.

Response

[
  {
    "id": "mkt_01jabcdef",
    "title": "Minimal Weekly Digest",
    "category": "template",
    "purchased_at": "2025-11-10T12:00:00Z",
    "download_url": "https://cdn.misarmail.com/marketplace/downloads/mkt_01jabcdef?token=...",
    "expiry": "2025-12-10T12:00:00Z"
  }
]

Purchase an Item

Purchase a marketplace item. Payment is deducted from your wallet balance first; if insufficient, your billing method on file is charged for the remainder.

POST /v1/marketplace/:id/purchase

Auth: Session required.

Response

{
  "success": true,
  "download_url": "https://cdn.misarmail.com/marketplace/downloads/mkt_01jabcdef?token=abc",
  "expiry": "2026-05-27T12:00:00Z"
}

Download URLs are signed and expire after 30 days. Re-download anytime within that window using the /download endpoint, or re-purchase to extend access. Free items never expire.

How payment works:

Your MisarMail wallet balance is checked first
If wallet covers the full amount — it is deducted immediately, no charge to your card
If wallet is insufficient — the shortfall is charged to your saved payment method
If no payment method is saved and wallet is insufficient — the request returns 402 Payment Required

Error cases:

Error	HTTP	Meaning
`item_not_found`	404	No item with that ID
`already_purchased`	409	You already own this item
`payment_required`	402	Insufficient wallet balance and no payment method

Download a Purchased Item

Re-download a previously purchased item. Generates a fresh signed URL valid for 24 hours.

POST /v1/marketplace/:id/download

Auth: Session required.

Response

{
  "success": true,
  "download_url": "https://cdn.misarmail.com/marketplace/downloads/mkt_01jabcdef?token=xyz",
  "expiry": "2026-05-28T12:00:00Z"
}

Returns 403 Forbidden if you have not purchased the item.

Submit a Review

Submit a rating and written review for a purchased item. One review per user per item. You must have purchased the item before you can review it.

POST /v1/marketplace/:id/review

Auth: Session required.

Request body

{
  "rating": 5,
  "review": "Excellent template — saved me hours of design work. Renders perfectly in Gmail and Apple Mail."
}

Field	Type	Constraints
`rating`	integer	1–5 (required)
`review`	string	Max 1000 characters (required)

Response

{
  "success": true,
  "review_id": "rev_01jabcxyz"
}

Error cases:

Error	HTTP	Meaning
`not_purchased`	403	You must purchase the item before reviewing
`already_reviewed`	409	You have already submitted a review for this item

Submit a New Item

Submit your own template, integration, or add-on to the marketplace. All submissions enter a review queue and are manually evaluated by the MisarMail team before going live.

POST /v1/marketplace/submit

Auth: Session required.

Request body

{
  "title": "Dark Mode Digest",
  "description": "A sleek dark-mode newsletter template optimised for Apple Mail dark mode.",
  "category": "template",
  "price_cents": 499,
  "preview_url": "https://your-cdn.example.com/preview.png",
  "download_url": "https://your-cdn.example.com/dark-mode-digest.zip",
  "tags": ["dark-mode", "digest", "premium"]
}

Field	Type	Required	Description
`title`	string	Yes	Item title, max 100 characters
`description`	string	Yes	Short description, max 500 characters
`category`	string	Yes	`template`, `integration`, or `addon`
`price_cents`	integer	Yes	Set to `0` for free items
`preview_url`	string	Yes	HTTPS URL to a preview image (min 800×600px)
`download_url`	string	Yes	HTTPS URL to the downloadable asset (zip)
`tags`	string[]	No	Up to 10 tags

Response 202

{
  "success": true,
  "submission_id": "sub_01jabcdef",
  "status": "pending_review",
  "message": "Your submission is under review. You'll receive an email once it's approved or if we need more information."
}

Submissions typically take 3–5 business days to review. Items are rejected if they contain external tracking scripts, malicious code, or assets you do not own. Repeated violations result in account suspension from the marketplace.

Review outcomes are emailed to your account address. Approved items go live immediately and you receive 70% of each sale.