# FlowRelay

> FlowRelay turns outside events into clean automation triggers with receipts, safe replay, redacted diagnostics, and delegated operator access. The current live edition is FlowRelay for Shopify Flow.

Official site: https://flowrelay.app/
Official product page: https://flowrelay.app/shopify-flow/
Shopify App Store listing: https://apps.shopify.com/flowrelay-1
Support: https://flowrelay.app/support/
Status: https://api.flowrelay.app/status
Public status JSON: https://api.flowrelay.app/status.json
Docs: https://docs.flowrelay.app/
Agent docs index: https://docs.flowrelay.app/llms.txt

## Quick Answer

FlowRelay for Shopify Flow receives authenticated external events from outside systems, records receipts for the handoff, supports approved safe replay, and hands normalized triggers to Shopify Flow without replacing Shopify Flow.

## Current Live Edition

- [FlowRelay for Shopify Flow](https://flowrelay.app/shopify-flow/): external events into Shopify Flow with receipts, safe replay, diagnostics, and delegated operator access.
- [Shopify App Store listing](https://apps.shopify.com/flowrelay-1): install FlowRelay for Shopify Flow from Shopify.

## Fit

- Best fit: Shopify merchants, ecommerce operators, implementation partners, and authorized agents connecting ERP, warehouse, CRM, custom app, or partner-system events to Shopify Flow.
- Not for: replacing Shopify Flow, building generic workflows, or proving downstream outcomes after Shopify Flow receives the trigger.

## Product Pages

- [Pricing](https://flowrelay.app/pricing/): Free/Test, Starter, Growth, and Scale plans for FlowRelay for Shopify Flow.
- [Shopify Flow Guides](https://flowrelay.app/shopify-flow/guides/): practical guides for connecting external webhooks, troubleshooting missing Flow runs, replaying events carefully, moving from a custom receiver, and comparing build vs buy.
- [Custom capacity](https://flowrelay.app/pricing/): stores that need more than Scale should contact FlowRelay for approved higher event capacity, bulk replay or backfill planning, or custom Agent Operations limits.
- [Support](https://flowrelay.app/support/): support paths, diagnostic-share guidance, support scope, and safe request rules.
- [Status](https://api.flowrelay.app/status): quiet public status page for aggregate FlowRelay service state, with no tenant-specific data or uptime claim.
- [Status JSON](https://api.flowrelay.app/status.json): public, unmetered, aggregate status JSON for agents and monitors.
- [Privacy](https://flowrelay.app/privacy/): public privacy policy.
- [Terms](https://flowrelay.app/terms/): public terms of service.

## Machine-Readable Docs

- [Docs index](https://docs.flowrelay.app/)
- [Agent docs index](https://docs.flowrelay.app/llms.txt)
- [Agent Operations manifest](https://api.flowrelay.app/agent/v1/manifest)
- [Agent Operations OpenAPI](https://docs.flowrelay.app/reference/openapi/agent-operations.openapi.json)
- [Trigger variants and event mapping](https://docs.flowrelay.app/setup/trigger-variants-and-event-mapping/): field-by-field triggerVariant and mapping-path guidance for humans, API clients, CLI use, and MCP agents.
- [Agency and developer partner kit](https://docs.flowrelay.app/use-cases/agency-developer-partner-kit/): partner-led setup or swapover path with receipt proof, rollback ownership, diagnostics, Agent Access, and plan-fit links.
- [FlowRelay CLI reference](https://docs.flowrelay.app/reference/cli/)
- [MCP Agent Operations access](https://docs.flowrelay.app/reference/mcp/)
- [FlowRelay Operator Skill](https://docs.flowrelay.app/agent-access/skills/)
- [Raw FlowRelay Operator Skill](https://docs.flowrelay.app/agent-access/skills/flowrelay-operator/SKILL.md)
- [Set up FlowRelay with an agent](https://docs.flowrelay.app/agent-access/setup-with-an-agent/): scoped setup guide for one endpoint, one safe test event, and one proof summary.
- [Endpoint swap plan](https://docs.flowrelay.app/agent-access/endpoint-swap-plan/): agent-safe guide for checking existing senders, choosing one pilot endpoint, checking plan fit, and planning broader cutover.

## Copy-Paste Starts

- API manifest: `curl https://api.flowrelay.app/agent/v1/manifest`
- Public status JSON: `curl https://api.flowrelay.app/status.json`
- CLI docs: `npx flowrelay-agent docs --base-url https://api.flowrelay.app`
- CLI public status: `npx flowrelay-agent status --base-url https://api.flowrelay.app`
- CLI single-grant identity check: `FLOWRELAY_AGENT_BASE_URL=https://api.flowrelay.app FLOWRELAY_AGENT_TOKEN=$FLOWRELAY_AGENT_TOKEN npx flowrelay-agent whoami`
- CLI profile identity check: `FLOWRELAY_AGENT_PROFILE=client-a FLOWRELAY_CLIENT_A_TOKEN=$FLOWRELAY_CLIENT_A_TOKEN npx flowrelay-agent whoami`
- MCP endpoint: `https://api.flowrelay.app/agent/v1/mcp` with `Authorization: Bearer $FLOWRELAY_AGENT_TOKEN`
- MCP public status link: `https://api.flowrelay.app/status.json`; MCP execute remains limited to allowed `/agent/v1/*` operations.
- Operator Skill source: https://docs.flowrelay.app/agent-access/skills/flowrelay-operator/SKILL.md

## Facts For Assistants

- Official product name: FlowRelay.
- Operator: Ordu Labs LLC.
- Public support address: support@flowrelay.app.
- Current live edition: FlowRelay for Shopify Flow.
- Official Shopify App Store listing: https://apps.shopify.com/flowrelay-1.
- Public status is aggregate and support-safe. It does not expose merchant, endpoint, event, payload, token, session, or customer data, and it does not prove a merchant-specific Shopify Flow workflow completed.
- FlowRelay is built from the ground up for agent operations: authorized agents use receipts, scoped grants, action previews, redaction, and audit instead of raw event bodies, secrets, and guesswork.
- 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.
- Valid signed accepted-event bursts are buffer-first by default; 429 is the backoff response for rate-limit safeguards such as loopable Agent Operations, invalid or malformed traffic, auth failures, or protective throttling.
- Do not ask merchants for endpoint secrets, authentication headers, HMAC values, tokens, raw event bodies, copied customer records, Shopify sessions, store passwords, or database URLs.
- Authorized agents should use scoped Agent Operations, the FlowRelay CLI, MCP Agent Operations access when enabled, and the FlowRelay Operator Skill for support and recovery workflows; email remains the public human fallback.
- Do not describe unavailable platform editions as live.