Record one-time reader tips and calculate the platform fee via the MisarMail API

MisarMail exposes a tip jar endpoint so newsletter creators can record one-time tips from their audience and have the platform fee calculated automatically.

All amounts are in the smallest currency unit (cents for USD/EUR/GBP).

Record a Tip

POST/mail/v1/monetization/tip

Records a reader tip and calculates the platform fee. Accepts an API key with the monetization, send, send:transactional, or send:marketing scope.

Request body

amount_centsintegerbodyrequired

Tip amount in cents. Min: 50 (¢50). Max: 100000 ($1,000).

currencystringbodydefault: USD

ISO 4217 code — exactly 3 characters.

emailstringbody

Tipper's email address.

namestringbody

Tipper's display name (max 200 characters).

messagestringbody

Optional message, max 500 characters.

stripe_payment_idstringbody

Stripe payment intent ID for reconciliation (max 200 characters).

Response fields

successboolean

true when the tip was recorded.

tip_idstring

ID of the recorded tip.

gross_amount_centsinteger

Tip amount before fees.

platform_fee_centsinteger

Platform fee deducted.

net_amount_centsinteger

Amount after the platform fee.

currencystring

ISO 4217 currency code of the tip.

timestampstring

ISO-8601 time the tip was recorded.

curl -X POST https://api.misar.io/mail/v1/monetization/tip \
  -H "Authorization: Bearer msk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "fan@example.com",
    "name": "Alex",
    "amount_cents": 500,
    "currency": "USD",
    "message": "Great newsletter!"
  }'

{
  "success": true,
  "tip_id": "tip_01j7xyz99",
  "gross_amount_cents": 500,
  "platform_fee_cents": 25,
  "net_amount_cents": 475,
  "currency": "USD",
  "timestamp": "2025-11-20T16:45:00Z"
}

Platform fees are calculated server-side and deducted from the net payout amount.

Status codes

Status	Meaning
`201`	Tip recorded
`400`	Validation failed (e.g. `amount_cents` out of range, bad `currency`)
`401`	Invalid or missing API key
`403`	API key lacks the `monetization` / `send` scope
`500`	Failed to record the tip

Monetization

Record a Tip

Status codes