Mailchimp
Mailchimp events are tied to a subscriber's email address. Customers must already be subscribed to your Mailchimp audience for events to appear on their profile. Events sent for non-subscribers are silently ignored.
Setup
Step 1: Create an API key
- In Mailchimp, click your account name in the bottom-left and go to Account & billing.
- Go to Extras → API Keys → Create A Key.
- Give it a name (e.g. "Stashlist") and copy the generated key.
Step 2: Find your Audience ID
- Go to Audience → All Contacts.
- Click Settings → Audience name and defaults.
- Copy the Audience ID shown on that page.
Step 3: Connect in Stashlist
- In your Shopify admin, go to Apps → Stashlist → Integrations → Mailchimp.
- Paste your API Key and Audience ID.
- Click Connect.
Step 4: Build an automation in Mailchimp
- In Mailchimp, go to Automations → Create.
- Choose Custom trigger and select the event name you want to act on (e.g.
wishlist_price_drop). - Add email steps using the event properties as merge tags.
Events reference
Stashlist sends these events to the Mailchimp Member Events API for each subscribed customer.
Event name When it fires
wishlist_add A logged-in customer saves a product to their wishlist wishlist_remove A logged-in customer removes a product from their wishlist wishlist_price_drop A wishlisted product's price drops by 10% or more (default, configurable in Stashlist → Integrations) wishlist_back_in_stock An out-of-stock wishlisted product becomes available again wishlist_low_in_stock Inventory for a wishlisted product drops below 5 units (default, configurable) Event properties
Every event includes a properties object with:
Property Description
product_id Shopify product ID (numeric string) variant_title The specific variant saved, e.g. "Blue / Large" product_url Full storefront URL of the product image_url Product image URL price Product price as a decimal string at the time of the event new_price New (dropped) price (wishlist_price_drop only) inventory_count Current inventory count (wishlist_low_in_stock only) What Mailchimp can do with these events
- Price drop emails: trigger an automation when a wishlisted product drops in price, with a personalised email linking directly to the product.
- Back in stock alerts: automatically email customers when a sold-out item they saved becomes available again.
- Post-save nurture: start a journey when a customer saves a product and follow up if they haven't purchased within a set number of days.
- Segmentation: create segments of customers who have fired specific wishlist events and target them with relevant campaigns.
- Low inventory urgency: send a "selling fast" email when inventory on a wishlisted item drops below 5 units.