FlowRelay
Recover
Error codes
Use stable FlowRelay error codes to decide what the product can prove and what the next safe action is.
Read the code before acting #
A FlowRelay error 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 stable code, receipt ID, and diagnostics package. Do not include raw bodies, full headers, secrets, tokens, sessions, database URLs, customer data, or copied private incidents.
Decision guide
Start with the receipt, then choose the lowest-risk recovery path.
- 01Open the receipt and find the stable FlowRelay error code.
- 02Read what FlowRelay can prove from that code, such as authentication failure, validation failure, missing workflow readiness, or handoff failure.
- 03Follow the next safe action for the code before replaying or changing endpoint configuration.
- 04Use diagnostics when a partner or support team needs redacted evidence.
- 05Escalate 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.