Replace custom intake
Move a custom webhook receiver into FlowRelay.
Start with one receiver you understand well. Keep the current route available while you test FlowRelay, and make sure one person owns both the cutover and the rollback.
Choose a low-risk receiver to move first.
Start with a useful receiver that the team understands, not the most critical one. You should know who owns it, how to test it, and how to switch back.
- Sender
- You know which system sends the event and who is responsible for it.
- Current receiver
- You know the URL or service that receives the event today.
- Owner
- One person owns the cutover and knows who owns both the sender and the current receiver.
- Flow trigger
- You know which Shopify Flow workflow should receive the event and which FlowRelay trigger it uses.
- Test
- You know which event to send and what the receipt should show.
- Rollback
- The old URL still works, and someone can restore traffic to it.
Change how the event arrives—not what the workflow does.
Shopify Flow keeps the same conditions and actions. Only the route into the trigger changes, and the new receipt records what happened at that handoff.
-
01
Inventory
Write down the sender, current URL, owner, event, Shopify Flow target, expected volume, known failure behavior, and rollback steps.
-
02
Configure
Create the matching FlowRelay endpoint without changing the Shopify Flow workflow.
-
03
Connect
Add or confirm the matching FlowRelay trigger in Shopify Flow.
-
04
Test
Send one representative event and check authentication, mapping, Flow readiness, and handoff status in the receipt.
-
05
Switch
Send live traffic to FlowRelay only after the test passes and the rollback steps are clear.
-
06
Retire
Remove the old receiver only after the FlowRelay route has worked reliably with live traffic.
Keep rollback boring.
Do not retire the current receiver while you are still learning how the FlowRelay route behaves. Record who can switch traffic back, which URL to restore, how to make the change, and what would trigger a rollback.
Switch only when: the test event produced the expected receipt, the Shopify Flow trigger was ready, and someone other than the implementer knows how to restore the old route.
Some endpoint inventory is manual.
FlowRelay cannot automatically find webhook URLs hidden in private repositories, serverless functions, installed apps, middleware routes, or automation tools. Before setting a cutover date, identify where the sender posts today and who owns that receiver.
Move one receiver, test it, and keep the old route ready.
Once the receipt confirms the handoff and another operator can restore the old route, you can plan the next receiver.