# 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. Open Shopify Admin, open Shopify Flow, and create a workflow for the event you want to receive.
2. Choose the FlowRelay trigger that matches the endpoint event type.
3. Add conditions and actions that are safe for a synthetic test, avoiding customer emails, fulfillment changes, and production mutations.
4. Save and enable the workflow in Shopify Flow.
5. Return to FlowRelay, send one synthetic test event, and open the receipt to confirm the handoff.

## Match the trigger
The Shopify Flow workflow must use the FlowRelay trigger that matches the endpoint event type. A mismatch can produce an accepted FlowRelay event with no enabled workflow handoff.


## 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
A Delivered receipt confirms FlowRelay handed the trigger to Shopify Flow. To confirm branches or downstream actions, 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)
- [Create an endpoint](https://docs.flowrelay.app/setup/endpoints.md)
- [Read receipts](https://docs.flowrelay.app/operate/receipts.md)

## Safety Boundary
Do not include raw payloads, endpoint secrets, auth headers, HMAC values, Shopify tokens, Shopify sessions, database URLs, customer data, merchant incidents, or copied private logs in public examples.