FlowRelay
Getting Started
Send your first test event
Use this guide after an endpoint and safe Shopify Flow workflow already exist. It covers one sender request, its receipt, and the next safe action.
Steps
Complete these in order.
-
Confirm the existing setup
Open the existing endpoint and confirm its Source label, trigger variant, default or mapped event type, authentication mode, and enabled Shopify Flow workflow.
-
Send a synthetic event
Send one test event with synthetic data from the sender, using non-customer values that are safe to store in a test receipt.
-
Inspect the receipt
Open Event history in FlowRelay and inspect the receipt's authentication, validation, mapping, readiness, and handoff facts.
-
Check downstream results separately
If the receipt is Delivered, check Shopify Flow separately for any branch or downstream outcome that matters.
-
Follow the receipt outcome
If the event is rejected, waiting, failed, or in manual review, follow its support code before resending or replaying.
Verify an existing endpoint #
Use this check after endpoint creation, a credential rotation, or another setup change. 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 test event, not real customer or merchant data.
- Install FlowRelay from the Shopify App StoreIf setup is not complete yet, use the end-to-end First endpoint guide before this test-only guide.
Success check #
The receipt shows Accepted, then Delivered. Delivered means FlowRelay handed the trigger to Shopify Flow — after receiving, authenticating, validating, and normalizing the event. It does not show whether the Flow run finished or which branches matched; check that in Shopify Flow.
If it does not deliver #
Use the receipt outcome to pick the next owner instead of retrying blindly.
| Outcome | Likely owner | Next action |
|---|---|---|
| Authentication failed | Sender and endpoint setup | Fix the signing or static header setup, then ask the sender to send a fresh test event. |
| Required field or mapping failed | Sender payload or endpoint mapping | Fix the payload field path or sender event body. Use a sender resend because FlowRelay rejected the event before a successful handoff. |
| No matching Shopify Flow workflow | Shopify Flow setup | Enable the matching FlowRelay trigger, then preview replay if the accepted event is still retained. |
| Handoff failed | FlowRelay to Shopify Flow boundary | Read the support code, confirm replay availability, and share diagnostics if support or a partner needs evidence. |
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.