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.

Shopify 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 Shopify 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 Shopify 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, Shopify Flow sends an HTTP request (POST) to your app. Shopify Flow waits for your app to respond with an HTTP status code. When Shopify Flow receives the response, it processes the codes:

Error code How Shopify Flow processes them
2XX Success Shopify 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 Shopify 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 Shopify 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 Shopify Flow resends the HTTP request (POST) after the wait time has passed.

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

5XX Server errors Shopify 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

Sign up for a Partner account to get started.

Sign up