Skip to Content
🎉 Mailprex 1.0 is soon to released. Read more →
User fields guide

User fields guide

The POST /email/send endpoint accepts JSON and delivers a formatted email to the address you specify in emailDestiny.

Base URL: https://api.mailprex.excelso.xyz/email/send

Required fields

FieldTypeDescription
emailDestinystringRecipient inbox for the notification email
fullnamestringName entered in the form
emailstringEmail entered in the form
messagestringMessage body
webNamestringWebsite or form label (used in subject line)
formTokenstringPrivate token from the dashboard (mk_live_…)

Optional fields

FieldTypeDescription
phonestringSender phone number
servicestringService or topic
captchaTokenstringCloudflare Turnstile token (required when CAPTCHA is enabled on the API)

Validation and limits

  • Invalid or missing token → 401
  • Monthly quota exceeded → 429
  • Too many sends to the same recipient per hour → 429

Plan limits: Free 200/month, Pro 5,000/month, Business unlimited.

Token security

  • New tokens use prefix mk_live_ and are stored as a bcrypt hash server-side.
  • The dashboard shows only a prefix after generation; regenerate if you lose the secret.
  • Legacy UUID tokens still work until regenerated.

See Migration v2.

Last updated on
Mailprex Docs 2026 © Mailprex.