Skip to main content

🔗 Sharing a Wishlist

The Wishlist Plugin supports sharing a wishlist via a secure token system.

📤 How It Works​

  1. A user (guest or customer) clicks "Share"
  2. Your frontend calls the POST /store/wishlists/:id/share endpoint
  3. The server returns a share token
  4. You generate a shareable link (e.g. /wishlist/import?token=...)
  5. Another user (guest or logged-in) opens the link
  6. Your frontend uses the token to import the list using POST /store/wishlists/import

✨ Use Cases​

  • 🛍 Sharing curated lists with friends
  • 🎁 Gift wishlists for birthdays or weddings
  • 👤 Guest → Guest transfers
  • 🧑‍🤝‍🧑 Guest → Logged-in or vice versa

🔐 Is It Secure?​

Yes. The token is signed using your plugin’s shareTokenSecret, and includes only the wishlist_id.
No private user data is embedded.

📬 Share a Wishlist​

const { share_token } = await sdk.alphabite.wishlist.share({
  id: "wl_...",
});
API Reference

Learn more about our Medusa SDK Wrapper Alphabite Medusa SDK Wrapper 🔗

You can view the full endpoint documentation for Create a Wishlist 🔗

Frontend Example:​

Generate a shareable link like:

https://yourstore.com/wishlist/import?token=eyJhbGciOi

📥 Import a Wishlist​

const { share_token } = await sdk.alphabite.wishlist.import({
  share_token: "ey...",
});
API Reference

Learn more about our Medusa SDK Wrapper Alphabite Medusa SDK Wrapper 🔗

You can view the full endpoint documentation for Create a Wishlist 🔗

📝 Notes​

  • Works for both guest and logged-in customers
  • The import operation copies the original list — it doesn’t link or transfer it
  • You can choose to:
    • Automatically import on page load (e.g. /wishlist/import)
    • Or show a confirmation modal before import

🔗 Related​