Kit integration for Medusa
Kit (formerly ConvertKit) is a newsletter tool. The plugin signs customers up from the store's form straight onto your Kit list, with tags and double opt-in, and gives buyers who are already on the list tags for what they bought. The Medusa admin shows how the list grows and how the latest broadcasts did.
What exactly
this integration does
-
The store's form
An e-mail address, optionally with a first name and where the sign-up came from, lands on your Kit list with the tags from the settings. Signing up the same address again changes nothing on the list.
-
Double opt-in
With double opt-in on, a new subscriber waits for confirmation, and Kit itself sends the e-mail with the link, from the form picked in the admin.
-
Tags by source
Every form in the store says where the sign-up came from, say the footer or a "notify me about the next drop" button, and gets its own tags next to the general ones.
-
Tags for buyers
After an order, an address that is already an active subscriber gets the buyer tags and, if you want, a tag for every product bought. Buying alone never puts anyone on the list.
-
The list and broadcasts in the admin
Active subscribers, growth over 30 and 90 days, open and click rates, and for the latest broadcasts the recipients, opens, clicks and unsubscribes. Kit's numbers are read only.
-
A log of every sign-up
Every attempt with its outcome and Kit's answer, so you see at once which address did not go through and why.
How it guards
your data
-
Consent first
An order never subscribes anyone, and with double opt-in on nobody gets an e-mail before confirming the sign-up.
-
The API key stays on the server
The key goes only to api.kit.com, the admin shows its last four characters, and it is masked in logs and error messages.
-
Protection from spam
The public form takes at most 5 sign-ups from one IP address in 10 minutes and checks the address before anything reaches Kit.
-
The list stays in Kit
The plugin sends no newsletters and keeps no copy of the list. Kit sends, Medusa only adds subscribers and tags.
Setup
in three steps
The full list of options, events and API routes is in the package README on GitHub.
Paste it into Claude Code, Cursor or another AI assistant in your Medusa project: it installs and configures the integration, with writes off.
- 1 Install the package from npm.
npm install @koda-plus/medusa-plugin-kit - 2 Add the plugin to medusa-config.ts.
plugins: [{ resolve: "@koda-plus/medusa-plugin-kit", options: { apiKey: process.env.KIT_API_KEY, // Kit: Settings, Developer, API keys (v4) storefrontUrl: "https://shop.example.com", // The defaults of the list settings; the admin overrides them: // doubleOptIn: true, // formId: process.env.KIT_FORM_ID, // the double opt-in form // tags: process.env.KIT_TAGS, // "123,456" // demo: true, // a sample Kit account, nothing sent to Kit }, }] - 3 Run the migrations and open the integration in the Medusa admin.
npx medusa db:migrate
Other
integrations
- Allegro Offers, orders, stock and parcels
- Base Cards, stock, prices and orders both ways
- Subiekt nexo Orders as ZK, WZ and invoices with KSeF
- Fakturownia Invoices, corrections and KSeF exactly once
- InPost Parcel lockers, courier and COD on ShipX
- InPost Von Halsky Sell in the InPost Mobile app straight from Medusa
- DPD DPD courier, Pickup points and COD on the DPD Polska API
- OLX Adverts that match the store's stock
- Stripe Volume, fees, disputes and account health
- Negotiations Target price, counter offer, acceptance
- Trade credit Limits, terms and customer balances
- Loyalty Points, a reward ladder and a ledger
- Coupons A three-step creator and the results of every coupon
- Packaging Piece, box, pallet, minimum and step
- EU compliance GPSR, RODO and Omnibus in one panel
- VAT whitelist NIP, VIES and REGON in one panel
- E-mails Ready templates in Polish and English
- Tasks Tasks on orders, products and customers
Tell us about your project,
we'll tailor the rest to you
A 15-minute call is enough for us to know whether we are a fit for your project.
We start from what you need, not from an off-the-shelf solution.