Add the Shopify Flow trigger

# Add the Shopify Flow trigger

Canonical: https://docs.flowrelay.app/setup/shopify-flow-trigger/
Markdown: https://docs.flowrelay.app/setup/shopify-flow-trigger.md

Shopify Flow owns the workflow logic. FlowRelay owns the reliable handoff into the matching trigger.

## Steps
Complete these in order.
1. Create the Shopify Flow workflow
   Open Shopify Admin, open Shopify Flow, and create a workflow for the event you want to receive.
2. Choose the matching trigger
   Choose the FlowRelay trigger that matches the endpoint trigger variant.
3. Add routing conditions when shared
   When the trigger variant is shared, add conditions for the endpoint Source label and resolved Event type; then add actions that are safe for synthetic test data.
4. Enable the workflow
   Save and enable the workflow in Shopify Flow.
5. Send a synthetic test
   Return to FlowRelay, send one test event, and open the receipt to confirm the handoff.
6. Check the downstream result separately
   Delivered means FlowRelay handed the trigger to Shopify Flow. Inspect Shopify Flow separately for branches and downstream actions.

## Match the trigger
The Shopify Flow workflow must use the FlowRelay trigger that matches the endpoint trigger variant. A mismatch can produce an accepted FlowRelay event with no enabled workflow handoff. When more than one endpoint or workflow uses the same trigger variant, add Shopify Flow conditions for the endpoint Source label and the resolved Event type so only the intended workflow path runs.

- [Install FlowRelay from the Shopify App Store](https://apps.shopify.com/flowrelay-1): Install FlowRelay before adding the matching FlowRelay trigger in Shopify Flow.

## Before choosing the Flow trigger
If the operator is unsure whether the endpoint should be generic, native order/customer/product, or related-resource inventory/fulfillment/return/company, use the trigger variants and event mapping reference before enabling the Shopify Flow workflow.

- [Trigger variants and event mapping](https://docs.flowrelay.app/setup/trigger-variants-and-event-mapping/): Choose the matching FlowRelay trigger and identifier path.

## Keep the first workflow safe
For the first proof, use conditions and actions that are safe with synthetic data. Avoid customer emails, fulfillment changes, inventory mutations, and production side effects until the receipt confirms the handoff.


## Success check
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. Inspect Shopify Flow run behavior separately.


## If Shopify Flow does not run
Check that the workflow is enabled, the trigger variant matches the endpoint, required identifiers are mapped, and the test data satisfies Shopify Flow conditions.


## Handoff Boundary
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.

## Related
- [Send your first test event](https://docs.flowrelay.app/getting-started/first-event.md)
- [Trigger variants and mapping](https://docs.flowrelay.app/setup/trigger-variants-and-event-mapping.md)
- [Create an endpoint](https://docs.flowrelay.app/setup/endpoints.md)
- [Read receipts](https://docs.flowrelay.app/operate/receipts.md)

## Safety Boundary
Do not share endpoint secrets, authentication headers, HMAC values, tokens, raw event bodies, customer records, Shopify sessions, store passwords, or database URLs in public examples.