FlowRelay FlowRelay Docs Shopify Flow
Website → Set up FlowRelay →
All docs pages

START

USE CASES

SET UP

OPERATE

RECOVER

AGENT ACCESS

REFERENCE

Setup

Add the Shopify Flow trigger

Shopify Flow owns the workflow logic. FlowRelay owns the reliable handoff into the matching trigger.

Next step Continue with Send your first test event.

Steps

Complete these in order.

  1. Open Shopify Admin, open Shopify Flow, and create a workflow for the event you want to receive.

  2. Choose the FlowRelay trigger that matches the endpoint event type.

  3. Add conditions and actions that are safe for a test event with synthetic data, avoiding customer emails, fulfillment changes, and production mutations.

  4. Save and enable the workflow in Shopify Flow.

  5. Return to FlowRelay, send one test event, and open the receipt to confirm the handoff.

  6. Delivered means FlowRelay handed the trigger to Shopify Flow. Inspect Shopify Flow separately for branches and downstream actions.

Match the trigger #

The Shopify Flow workflow must use the FlowRelay trigger that matches the endpoint trigger variant. A mismatch can produce an accepted FlowRelay event with no enabled workflow handoff.

Before choosing the Flow trigger #

If the operator is unsure whether the endpoint should be generic, native order/customer/product, or related-resource inventory/fulfillment/return/company, use the trigger variants and event mapping reference before enabling the Shopify Flow workflow.

Keep the first workflow safe #

For the first proof, use conditions and actions that are safe with synthetic data. Avoid customer emails, fulfillment changes, inventory mutations, and production side effects until the receipt confirms the handoff.

Success check #

Delivered means FlowRelay handed the trigger to Shopify Flow. It does not mean downstream Shopify Flow branches, app calls, fulfillment changes, emails, or later systems completed. Inspect Shopify Flow run behavior separately.

If Shopify Flow does not run #

Check that the workflow is enabled, the trigger variant matches the endpoint, required identifiers are mapped, and the test data satisfies Shopify Flow conditions.

Handoff boundary

Delivered means FlowRelay handed the trigger to Shopify Flow. It does not mean downstream Shopify Flow branches, app calls, fulfillment changes, emails, or later systems completed.