FlowRelay Docs Shopify Flow
Website → Start setup →
All docs pages

START

USE CASES

SET UP

OPERATE

RECOVER

AGENT ACCESS

REFERENCE

Getting Started

Send your first test event

Use this guide to prove the setup once with synthetic data before you send real business events.

Next step Continue with Create an endpoint.

Steps

Complete these in order.

  1. 01Open Shopify Admin, open FlowRelay, and create a test endpoint for the sender or system you control.
  2. 02Choose the event type Shopify Flow should receive. Use Generic for the first proof when no specific type is required.
  3. 03Choose HMAC-SHA256 when the sender can sign requests; otherwise use static-header auth and store the generated value privately.
  4. 04In Shopify Flow, create a safe workflow with the matching FlowRelay trigger and a harmless test action.
  5. 05Send one synthetic JSON event from the sender, using non-customer values that are safe to store in a test receipt.
  6. 06Open Event history in FlowRelay, open the receipt, and confirm Delivered only means FlowRelay handed the trigger to Shopify Flow.

Before you start #

Use a Shopify store where FlowRelay is installed, a sender you control, and a Shopify Flow workflow that is safe to run. Send synthetic values for the first event, not real customer or merchant data.

Success check #

The first successful proof ends with a FlowRelay receipt that shows the event was accepted and Delivered. That means FlowRelay received, authenticated, validated, normalized, and handed the trigger to Shopify Flow.

If it does not deliver #

Use the receipt outcome to pick the next owner instead of retrying blindly.

OutcomeLikely ownerNext action
Authentication failedSender and endpoint setupFix the signing or static header setup, then ask the sender to send a fresh synthetic event.
Required field or mapping failedSender payload or endpoint mappingFix the JSON path or sender payload. Use a sender resend because FlowRelay rejected the event before a successful handoff.
No matching Shopify Flow workflowShopify Flow setupEnable the matching FlowRelay trigger, then preview replay if the accepted event is still retained.
Handoff failedFlowRelay to Shopify Flow boundaryRead the error code, confirm replay availability, and share diagnostics if support or a partner needs evidence.
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.