Getting Started with Integration Workflows

This guide walks you through connecting your first integration and building your first workflow from scratch.

Step 1 — Connect an integration

Before you can use an integration in a workflow, you need to connect it from the Integrations settings page.

  1. Go to Settings → Integrations
  2. Find the integration you want (e.g. HubSpot, Klaviyo, Shippo)
  3. Click Connect
  4. Enter your API key or OAuth credentials
  5. Click Save — the connection is tested automatically

Your credentials are encrypted with AES-256 before storage. LaunchStore never stores them in plain text.

Tip

You only need to connect an integration once per store. After that, any workflow you build for that store can use it.

Step 2 — Create a new workflow

  1. Go to Integrations → Workflows
  2. Click New Workflow
  3. Give your workflow a name (e.g. "Sync order to HubSpot")
  4. Click Create

Step 3 — Add a trigger node

The trigger is the store event that starts the workflow.

  1. On the canvas, click Add Trigger
  2. Select the event — e.g. order.created
  3. The trigger node appears on the canvas

Available triggers: order.created, order.fulfilled, order.canceled, order.refunded, customer.created, fulfillment.created

Step 4 — Add an action node

  1. Click the + handle on the trigger node
  2. Select the integration and action (e.g. HubSpot → Create Contact)
  3. Configure the action — map the fields from the event payload to the API call

Example field mapping for HubSpot Create Contact

HubSpot fieldSource
Email{{ order.email }}
First name{{ order.customer.first_name }}
Last name{{ order.customer.last_name }}
Phone{{ order.shipping_address.phone }}

Step 5 — Chain additional actions (optional)

You can connect multiple action nodes in sequence. For example:

order.created → HubSpot: Create Contact → Klaviyo: Identify Profile → Complete

Each action receives the same trigger payload. You can reference any field from the original event.

Step 6 — Save and activate

  1. Click Save — the workflow is saved as a Draft
  2. Click Activate — the workflow is translated into n8n JSON and deployed to the n8n cluster
  3. Status changes to Active

Once active, every matching store event triggers the workflow automatically.

Step 7 — Watch the first execution

  1. Place a test order in your store (or use your Medusa admin)
  2. Go to Integrations → Execution History
  3. You should see a new execution appear with status COMPLETED within seconds

If the execution shows FAILED, check the execution detail to see the error from n8n.

Managing workflows

ActionWhat it does
DeactivatePauses the workflow — no new executions until re-activated
EditModify nodes (workflow must be deactivated first)
DeleteArchives the workflow permanently
Tip

You need to deactivate a workflow before editing it. LaunchStore re-deploys it to n8n on the next activation.

Next steps