Markdown
Create an endpoint
Plain Markdown for agents, CLIs, MCP clients, and readers who want a copyable text version.
# Create an endpoint
Canonical: https://docs.flowrelay.app/setup/endpoints/
Markdown: https://docs.flowrelay.app/setup/endpoints.md
An endpoint is the private URL your sender uses to send events into FlowRelay.
## Steps
Complete these in order.
1. Open Shopify Admin, then open FlowRelay from Apps.
2. Choose Create endpoint and name it for the sender or workflow, such as Warehouse status to Flow.
3. Choose the event type Shopify Flow should receive. Use Generic for the first test if you are not sure which specific type fits.
4. Create the endpoint, then copy the endpoint URL only into the sender system or a private setup note.
5. Continue to authentication before asking the sender to send real events.
6. After the sender sends a test event, 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.
## Choose the event type
Pick the event type that matches the Shopify Flow trigger you plan to use. Start with Generic when the first proof only needs a custom event and no native Shopify resource reference.
## Success check
After the sender sends a synthetic event, 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 auth headers, signatures, raw payloads, Shopify tokens, customer data, or copied incidents into screenshots, tickets, public examples, or chat threads.
## 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
- [Authenticate requests](https://docs.flowrelay.app/setup/authentication.md)
- [Add the Shopify Flow trigger](https://docs.flowrelay.app/setup/shopify-flow-trigger.md)
- [Send your first test event](https://docs.flowrelay.app/getting-started/first-event.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.
FlowRelay