Integration Workflows — Overview
Integration Workflows connect your LaunchStore store to external tools — HubSpot, Klaviyo, Mailchimp, Pipedrive, Shippo, Stripe, and more — using a visual workflow builder powered by n8n.
What are Integration Workflows?
An integration workflow is a sequence of steps that runs automatically when a store event fires:
- Trigger — a Medusa event (order placed, customer created, etc.)
- Action(s) — calls to external APIs via n8n nodes (HubSpot, Klaviyo, Shippo, etc.)
Every time the trigger fires, n8n executes the full workflow using the credentials you provided. The result — success, failure, and n8n execution ID — is recorded in your dashboard.
How is this different from Marketing Automation?
| Marketing Automation | Integration Workflows | |
|---|---|---|
| Purpose | Email sequences (welcome, cart recovery, win-back) | CRM, marketing, and shipping tool sync |
| Execution | LaunchStore cron engine → SES/Resend | n8n → HubSpot/Klaviyo/Shippo/etc. |
| Triggers | customer events + daily cron (birthday, no engagement) | 6 real-time Medusa webhook events |
| Typical use | "Send 3 emails over 7 days after cart abandonment" | "Create a HubSpot contact every time an order is placed" |
Both systems listen to the same store events but serve completely different purposes.
Supported integrations
- HubSpot — Create Contact, Create Deal, Create Ticket
- Pipedrive — Create Contact, Create Deal
- Mailchimp — Add Subscriber, Update Subscriber
- Klaviyo — Identify Profile, Track Event
- SendGrid — Send Email
- Stripe — Create Customer
- PayPal — Create Payment
- Shippo — Create Shipment, Create Label
Available triggers
| Event | When it fires |
|---|---|
order.created | New order placed |
order.fulfilled | Fulfillment created |
order.canceled | Order cancelled |
order.refunded | Full or partial refund |
customer.created | New customer account |
fulfillment.created | Shipment tracking generated |
Architecture summary
Events flow from Medusa → LaunchStore backend (HMAC-authenticated webhook) → WorkflowEventService → BullMQ workflow-execution queue → WorkflowExecutionProcessor → N8nService.executeWorkflow() → n8n cluster.
n8n runs all the actual API calls to HubSpot, Klaviyo, and Shippo using credentials stored in n8n's encrypted credential store.