FlowRelay
Setup
Create an endpoint
An endpoint is the private URL your sender uses to send events into FlowRelay.
Steps
Complete these in order.
-
Open FlowRelay
Open Shopify Admin, then open FlowRelay from Apps.
-
Name the endpoint
Choose Create endpoint and name it for the sender or workflow, such as Warehouse status to Flow.
-
Choose the sending service
Enter an Endpoint name and Source label, then answer which service will send POST requests. Zapier, Make, and n8n receive the compatible static-header preset; custom HTTP/code receives the HMAC-SHA256 preset.
-
Adjust only when needed
Use Change trigger for Shopify-aware resource context. Use Advanced authentication and mapping for a deliberate auth override, custom event fields, identifiers, or required payload paths. A standard no-code sender paired with HMAC produces a compatibility warning.
-
Store the endpoint URL privately
Create the endpoint, then copy the endpoint URL only into the sender system or a private setup note.
-
Configure authentication
Continue to authentication before asking the sender to send real events.
-
Verify with a receipt
After the sender sends a test event with synthetic data, use Event history and the receipt to verify accepted, delivered, or failed status.
Who needs the endpoint URL #
Only the sender owner or private sender configuration needs the endpoint URL. Treat it like setup material, not public documentation or a support artifact.
- Install FlowRelay from the Shopify App StoreInstall FlowRelay before creating your first sender endpoint.
Understand the defaults and advanced controls #
The sender choice describes the outside service that makes the HTTP request; the trigger variant describes what Shopify Flow receives. They are separate decisions. The Source label identifies the endpoint in Shopify Flow, Generic is the recommended starting trigger, and external.event is the default event type. Open the technical controls when the sender needs an explicit override, the trigger must carry Shopify resource context, or the event type should come from a mapped payload value.
| Term | Meaning |
|---|---|
| Source label | The endpoint routing identity surfaced to Shopify Flow. |
| Trigger variant | Selects the FlowRelay trigger payload and native-reference shape. |
| Default event type | The fallback event label used when no mapped event-type path supplies one. |
| Resolved event type | The mapped event-type value when present; otherwise the endpoint's default event type. |
Success check #
After the sender sends a test event with synthetic data, Event history shows a receipt for the expected endpoint. If the event is not visible, verify the sender URL, auth setup, and whether the sender received a FlowRelay response.
Keep private #
Do not put endpoint URLs, generated secrets, full authentication headers, signatures, raw event bodies, Shopify tokens, customer data, or copied incidents into screenshots, tickets, public examples, or chat threads.
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.