Shopify Flow Integration

Appstle Subscriptions integrates natively with Shopify Flow, Shopify's built-in automation platform. Use Flow to automate subscription management without any API tokens or external authentication — everything runs securely within Shopify's ecosystem.

ℹ️ Why Shopify Flow? Shopify Flow actions run within Shopify's authenticated context, so there's no need for API tokens or credentials. This makes Flow the most secure way to automate subscription operations — perfect for merchants who want powerful automation without managing API keys.

1. In the Appstle admin, go to Settings → Integrations → Shopify Flow
2. Enable the Shopify Flow integration
3. Open the Shopify Flow editor in your Shopify admin
4. Create a new workflow using Appstle triggers and actions

Triggers fire automatically when subscription events occur. Use them to start Flow workflows.

All triggers include a full set of subscription and customer properties. Some triggers include additional context-specific fields.

Included with every trigger:

Included with every trigger:

For Subscription Billing Success, Subscription Billing Failure, and Upcoming Order Notification triggers only:

For Subscription Billing Success only:

For Subscription Updated trigger only:

The Line Items property is an array of objects, each representing a product line in the subscription:

The Order Note Attributes property is an array of key-value pairs:

Actions are operations you can perform on subscriptions from within a Flow workflow.

All actions return output fields that can be used in subsequent Flow steps. Every action returns at minimum a success_message field indicating the result of the operation.

Detailed input and output fields for each action. Use the summary tables above for quick reference.

Add a product variant to an existing subscription.

Input Fields:

Output Fields:

Remove a product from a subscription.

Input Fields:

Output Fields:

Change the quantity of a product in a subscription.

Input Fields:

Output Fields:

Change the price of a product in a subscription.

Input Fields:

Output Fields:

Update custom attributes on a line item.

Input Fields:

Output Fields:

Swap a product variant for another in a subscription.

Input Fields:

Output Fields:

Set a subscription's status to Active, Paused, or Cancelled.

Input Fields:

Output Fields:

Hide a subscription from the customer portal.

Input Fields:

Output Fields:

Combine two subscriptions into one.

Input Fields:

Output Fields:

Split specific line items into a new subscription.

Input Fields:

Output Fields:

Change the selling plan for a line item.

Input Fields:

Output Fields:

Update the order note on a subscription.

Input Fields:

Output Fields:

Update custom note attributes on a subscription.

Input Fields:

Output Fields:

Change the billing frequency.

Input Fields:

Output Fields:

Change billing and delivery frequency using an existing selling plan.

Input Fields:

Output Fields:

Reschedule the next billing date.

Input Fields:

Output Fields:

Skip (or unskip) the next scheduled order.

Input Fields:

Output Fields:

Trigger immediate billing/order placement.

Input Fields:

Output Fields:

Set the maximum number of billing cycles.

Input Fields:

Output Fields:

Set the minimum number of billing cycles.

Input Fields:

Output Fields:

Apply a discount code to a subscription.

Input Fields:

Output Fields:

Remove a discount from a subscription.

Input Fields:

Output Fields:

Update pricing policy with cycle-based discounts.

Input Fields:

Output Fields:

Change the delivery frequency.

Input Fields:

Output Fields:

Change the shipping method on a subscription.

Input Fields:

Output Fields:

Change the shipping price on a subscription.

Input Fields:

Output Fields:

Update the delivery address on a subscription.

Input Fields:

Output Fields:

Send a payment method update request to the customer.

Input Fields:

Output Fields:

Trigger: Subscription Billing Failure Condition: Check if this is the 3rd consecutive failure Action: Update Subscription Status → PAUSED

Trigger: Subscription Billing Success Condition: Current billing cycle ≥ 6 Action: Apply Discount Code → LOYAL10

Trigger: Subscription Cancelled Condition: Subscription value > $100/month Action: Send Slack notification (via Shopify Flow's Slack connector)

Trigger: Scheduled (monthly, via Shopify Flow's scheduler) Action: Replace Variant → swap summer product for winter product

Use these values for billing_interval and delivery_interval fields:

• DAY
• WEEK
• MONTH
• YEAR

Use these values for the status field:

• ACTIVE
• PAUSED
• CANCELLED

All date fields use ISO 8601 format: 2026-03-15T10:00:00Z

For attributes and note_attributes fields, use JSON array format:

[
  {"key": "gift_message", "value": "Happy Birthday!"},
  {"key": "delivery_instructions", "value": "Leave at door"}
]

• old_variant_id: Comma-separated variant IDs to replace (e.g., 12345,67890)
• new_variant_id: Comma-separated variant IDs with optional quantities (e.g., 11111:2,22222:1)

• Shopify Flow is available on Shopify Basic plan and above
• Flow actions require the Appstle Subscriptions app to be installed and the Flow integration enabled
• The Attempt Billing action requires additional permission — contact support to enable
• All actions are logged in the subscription activity log with source SHOPIFY_FLOW