Import, export, and endpoint templates

# Import, export, and endpoint templates

Canonical: https://docs.flowrelay.app/setup/import-export-templates/
Markdown: https://docs.flowrelay.app/setup/import-export-templates.md

Reuse a reviewed endpoint configuration in another setup without copying credentials, event history, source identities, or Shopify workflows.

## Steps
Complete these in order.
1. Preview an export
   Open Endpoint setup, select one or up to 20 endpoints under Export configuration, and choose Preview export file. Review the exact JSON, including any private text you wrote in expressions or defaults, then download it.
2. Prepare an import
   In the destination store, paste the portable JSON or choose a starter template. Review import checks the format version, fields, mappings, authentication requirements, and Shopify permissions. Duplicate names and source labels are renamed in the preview.
3. Confirm the complete batch
   Confirm the exact preview within 30 minutes. The whole batch is created together or none of it is. Retries of the same confirmed request do not create duplicates. Imports never overwrite existing endpoints.
4. Finish the destination setup
   Each imported endpoint has a new identity and URL and starts inactive. Configure a fresh generated credential or enter the sender-owned signing secret, update the sender, preview a synthetic sample, and build the destination Shopify workflow. Review activation only after the credential is configured.
5. Prove the destination
   Send an authenticated synthetic event to the new URL. Check FlowRelay's handoff receipt and separately confirm the expected condition/action in Shopify Flow before moving production traffic.

## What the file contains
The version-1 flowrelay.shopify-endpoints file contains descriptive settings, trigger variant, sender profile, authentication requirements, custom mapping, and validation. It excludes source URLs and endpoint IDs, secret values, grants, events, and store identifiers. Issuer/audience and user-written mapping literals are configuration and remain visible in the file.


## Five starter configurations
Choose Simple external event, Shopify order reference, n8n, Make, or Zapier. The order example needs the optional read_orders permission and a valid order reference from the destination store. A customer setup uses the customer trigger, its customer GID, and read_customers. No template queries or copies Shopify records.


## Limits and changes during review
A portable file is limited to 20 endpoints and 350,000 UTF-8 bytes. Unknown format versions and unknown fields are rejected. If permissions, endpoint settings, or conflicting names change after preview, prepare a fresh preview. Existing plan event and action allowances still apply; this feature does not change pricing.


## Configuration reuse is not workflow synchronization
Imports create independent endpoint configurations. Credentials and workflows are configured at the destination. Later source changes do not automatically update another store. There is no cross-store credential sharing or automatic fleet management.


## Related
- [Trigger variants and mapping](https://docs.flowrelay.app/setup/trigger-variants-and-event-mapping.md)
- [Authenticate requests](https://docs.flowrelay.app/setup/authentication.md)
- [Send your first test event](https://docs.flowrelay.app/getting-started/first-event.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.