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.
-
Set routing fields
Set a clear Source label and default event type, then choose the trigger variant Shopify Flow should receive. Use Generic when no native Shopify reference is needed.
-
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.
Set routing identity and trigger shape #
Keep Source label, trigger variant, default event type, and resolved event type separate. The Source label identifies the endpoint in Shopify Flow; the trigger variant selects the payload/reference shape; the resolved event type is a mapped value when present or the default otherwise.
| 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.