Start before FlowRelay.
Confirm the sender fired, the current receiver URL is correct, the network path is available, and authentication was placed where the endpoint expects it.
Troubleshoot a missing handoff
Why did my Shopify Flow not run?
If an external webhook should have started a Shopify Flow workflow but no run appears, start with one question: is there a FlowRelay receipt for the event? The answer tells you which system owns the next check.
What does the receipt state say?
Do not search every system at once. Use the strongest fact you have.
Review endpoint setup
FlowRelay saw the event but could not accept or map it.
Use the failure reason to check authentication, required fields, endpoint settings, trigger family, or mapping. Fix the stated condition before sending another production event.
Continue in Shopify Flow or the downstream app.
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 Flow conditions, branches, actions, and later business outcomes where they run.
Give support a narrow record, not a data dump.
A useful handoff names the event and expected outcome while keeping private inputs out of the ticket.
Include
- Receipt ID, endpoint name, status, and time window.
- Trigger family, support code, and redacted diagnostic share when available.
- The business outcome you expected, stated separately from the FlowRelay status.
Never share
- Endpoint secrets or authentication headers.
- Raw event bodies, tokens, or copied customer records.
- Broad store access when the receipt facts answer the intake question.
Use the receipt to choose one next check.
Open diagnostics, confirm the state, and continue with the sender, FlowRelay, Shopify Flow, or downstream system that owns the unresolved fact.