FlowRelay
Recover
Support codes
A support code is the short, stable code shown on a receipt that names where an event stopped — authentication, validation, workflow readiness, or the Shopify Flow handoff. Use it to decide what FlowRelay can prove and what the next safe action is, and quote it instead of pasting private request details.
Read the code before acting #
A FlowRelay support code explains the boundary where the event stopped. Use it to choose whether the sender, endpoint, Shopify Flow setup, FlowRelay processing, or support should own the next step.
Common recovery paths #
These examples describe FlowRelay-native recovery decisions rather than generic webhook behavior.
| Code family | What it means | Next action |
|---|---|---|
| Authentication failed | FlowRelay could not trust the request. | Fix sender auth and ask the sender to send a fresh event. |
| Validation or mapping failed | The request was missing required JSON, event type, or identifier data. | Fix the endpoint mapping or sender payload, then use a sender resend. |
| No workflow | FlowRelay accepted the event but no matching enabled Shopify Flow trigger was ready. | Enable the trigger, then preview FlowRelay replay if the event is retained. |
| Handoff failed | FlowRelay could not complete the handoff to Shopify Flow. | Check replay availability and share diagnostics if support needs evidence. |
| Retention expired | FlowRelay no longer has replayable event material. | Ask the sender to send a fresh event rather than reconstructing private data. |
Escalate safely #
Escalate with the support code, receipt ID, and diagnostics share. Do not share endpoint secrets, authentication headers, HMAC values, tokens, raw event bodies, customer records, Shopify sessions, store passwords, or database URLs.
Decision guide
Start with the receipt, then choose the lowest-risk recovery path.
-
Open the receipt and find the FlowRelay support code.
-
Read what FlowRelay can prove from that code, such as authentication failure, validation failure, missing workflow readiness, Shopify handoff retry, or handoff failure.
-
Follow the next safe action for the code before replaying or changing endpoint configuration.
-
Use diagnostics when a partner or support team needs redacted evidence.
-
Escalate when the code indicates an action outside the current operator or agent grant.
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.