Turn Visitors into Customers
Every commerce site needs a way to capture interest before a purchase. Whether it's a contact form, quote request, or general enquiry, managing these leads effectively can make the difference between a
conversion and a missed opportunity.
That's why we built the Leads Plugin for Medusa — a complete lead management solution that integrates seamlessly with your existing setup.
What It Does
The Leads plugin adds a full lead capture and management system to your Medusa store:
Contact Form API
A simple API endpoint that accepts form submissions from your storefront. Name, email, phone, company, and message — all captured and stored securely in your database.
Admin Dashboard
View, filter, and manage all leads directly in the Medusa admin. See new enquiries at a glance, update statuses, and never lose track of a potential customer.
Email Notifications
Automatic email alerts when new leads come in. Built with React Email and Resend for reliable, beautifully formatted notifications that land in your inbox instantly.
Status Tracking
Move leads through your pipeline: New → Contacted → Qualified → Converted. Keep your team aligned on where each opportunity stands.
How We Built It
The plugin follows Medusa's module architecture:
- Custom Module — Self-contained lead management with its own service, repository, and types
- API Routes — Both store (public submission) and admin (management) endpoints
- Subscriber — Event-driven email notifications via the EventBus
- Admin Extensions — Native UI components in the Medusa dashboard
No external dependencies. No third-party services required. Your data stays in your database.
Getting Started
Installation is straightforward:
# Add the module to your Medusa config
medusa-config.ts → modules: [{ resolve: "./src/modules/leads" }]
# Run migrations
npx medusa db:migrate
# Add your Resend API key for email notifications
RESEND_API_KEY=your_key_here
The storefront integration is equally simple — just POST to /store/leads with your form data.
What's Next
We're actively developing more features:
- Lead scoring based on engagement
- Integration with popular CRM platforms
- Automated follow-up sequences
- Analytics and conversion tracking
Open Source
This plugin is part of our commitment to the Medusa ecosystem. We'll be releasing it publicly so other developers can use it, learn from it, and contribute improvements.
If you're building on Medusa and need lead management, reach out — we'd love to help you get set up.
Anas Mahmud