Skip to content
mailprompt
Start free trial
Store integrationSingle-use codes

Medusa and Mailprompt

Mailprompt connects to a Medusa store with an admin key, reads the catalog and order data, and can create a single-use promotion code through the storefront API when you provide a storefront key.

What syncs

  • Products and variants
    Synced
  • Collections and categories
    Synced
  • Customers
    Synced
  • Orders and line items
    Synced

Mailprompt never edits your products, customers or orders. The only things it writes to the store are its own webhooks and tracking script where the platform allows it, and any single-use discount code an approved email asks for.

How to connect

  1. Open Settings → Store and choose Medusa.
  2. Paste the store URL and a Medusa admin API key with read access to the catalog.
  3. Optionally add a storefront API key so Mailprompt can create discount codes as well as read the catalog.

The connection lives in Settings → Store. Only an owner or admin can connect or disconnect a store, and the credentials are encrypted before they are stored.

Discount codes

  • Creates a unique, single-use code in the store for an approved email.
  • A code cannot require a minimum order subtotal.
  • A percentage code cannot be capped at a maximum amount.

These limits come from what the Medusa API can express. When a rule cannot be enforced in the store, the approval checklist explains it before anything sends.

Good to know

  • Discount codes need the optional storefront key; without it the catalog still syncs but Mailprompt will not create codes.
  • Medusa categories are linked with the /categories/<handle> storefront path assumption; confirm the path if your storefront uses a custom route.
  • Medusa cannot express a minimum order subtotal or a maximum-discount cap on the codes Mailprompt creates.