Guidelines and requirements

Guidelines and information for creating triggers and actions for your apps, including how HTTP status codes are handled, payload limitations, and rate limits.

Flow is available to Shopify Plus plans only. If your app tries to make POSTs to a non-plus store, then these calls are ignored by Flow.

Merchant Requirements

To create workflows that use your triggers and actions, merchant stores must have the following:

  • Shopify Flow installed
  • your app installed
  • a Shopify Plus plan

Trigger requirements and guidelines

Keep the following information in mind when you are creating your actions:

Requirement: Payload size

When you create a trigger, make sure that the payload that you send to Flow is less than 1 MB.

Requirement: Triggers are rate limited

Triggers have the same API call limits as the Shopify API.

Action requirements, information, and guidelines

Keep the following information in mind when you are creating your actions:

Information: HTTP status codes and retry exceptions

After your action runs, Flow sends an HTTP request (POST) to your app. Flow waits for your app to respond with an HTTP status code. When Flow receives the response, it processes the codes:

Error code How Flow processes them
2XX Success Flow assumes that the POST has been processed by your app. After the workflow runs, these responses appear in the workflow's run details.
3XX Redirection Flow assumes that the POST has been processed by your app. After the workflow runs, these responses appear in the workflow's results.
4XX Client errors

If your app sends a 429 (too many requests) error without a Retry-After header, then Flow resends the HTTP request (POST) at increasing intervals for up 3 days or until it receives a 2XX code.

If your app sends a 429 (too many requests) error with a Retry-After header (that specifies a wait time), then Flow resends the HTTP request (POST) after the wait time has passed.

If your app sends any other 4XX code, then Flow does not resend the POST. After the workflow runs, these responses appear in the workflow's results.

5XX Server errors Flow resends the HTTP request (POST) at increasing intervals for up 3 days or until it receives a different code (such as a 2XX code).

Learn more