Skip to main content

Documentation Index

Fetch the complete documentation index at: https://appstleinc-aeca3e0a.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Appstle Memberships integrates natively with Shopify Flow, Shopify’s built-in automation platform. You can automate membership operations — send emails, tag customers, update CRMs, trigger Slack alerts, and more — without writing any code. Flow actions run within Shopify’s authenticated context, so there is no need for API tokens or credentials. This makes Flow the most secure and straightforward way to automate membership operations.

Getting started

1

Enable the Flow integration

In your Appstle Memberships admin, go to Settings → Integrations → Shopify Flow and enable it.
2

Open the Shopify Flow editor

Navigate to the Shopify Flow editor in your Shopify admin.
3

Create a workflow

Click Create workflow, then select an Appstle Memberships trigger to start. All membership triggers appear under the Appstle Memberships app in the trigger picker.
Shopify Flow is available on Shopify Basic plan and above. All Flow trigger events are logged in the membership’s Activity Log with source SYSTEM_EVENT.

Membership lifecycle triggers

These triggers fire automatically when membership contracts change state. All lifecycle triggers include a full set of membership and customer properties.
TriggerHandleDescription
Membership Createdmembership-createdA new membership contract is created. Includes the order_id of the originating order.
Membership Updatedmembership-updatedMembership details are modified, such as address or custom attributes.
Membership Activatedmembership-activatedA paused or new membership becomes active.
Membership Pausedmembership-pausedMembership is put on pause.
Membership Cancelledmembership-cancelledMembership is cancelled.
Membership Expiredmembership-expiredMembership expires, or perks are removed for cancelled/paused memberships.
Membership Swap Productmembership-swap-productThe product or plan in a membership is changed.
Next Order Date Changednext-order-date-changedThe next renewal date is rescheduled.
Billing Interval Changedbilling-interval-changedBilling frequency is updated, for example monthly to annual.

Billing triggers

TriggerHandleDescription
Membership Billing Successmembership-billing-successRenewal payment processed successfully. Includes the new order ID.
Membership Billing Failuremembership-billing-failureRenewal payment failed. Use this to trigger dunning emails or pause logic.
The membership-billing-failure trigger fires on every failed attempt — not just the first one. Use the Billing Attempt Count property to distinguish first failures from retries so you don’t send duplicate emails to the same customer.

Trigger properties

All triggers include the following properties:

Membership properties

PropertyTypeDescription
Membership IDNumberInternal membership contract ID
StatusStringCurrent status: ACTIVE, PAUSED, CANCELLED, EXPIRED, FAILED
Next Billing DateDateTimeISO 8601 next renewal date
Billing IntervalStringBilling frequency unit: DAY, WEEK, MONTH, YEAR
Billing Interval CountNumberNumber of intervals between renewals (e.g., 1 for monthly, 12 for annual)
Membership Selling Plan NameStringName of the membership plan (e.g., “Gold Member — Monthly”)
Membership Selling Plan IDNumberShopify selling plan ID
product_idNumberShopify product ID for the membership product
Variant IDNumberShopify product variant ID
Original Order IDNumberOrder ID that created the membership
Original Order NameStringOrder name (e.g., “#1001”)

Customer properties

PropertyTypeDescription
customer_idNumberShopify customer ID
Customer EmailStringCustomer’s email address
Customer PhoneStringCustomer’s phone number
Customer Display NameStringCustomer’s full display name
Customer First NameStringCustomer’s first name
Customer Last NameStringCustomer’s last name

Billing event properties

The Membership Billing Success and Membership Billing Failure triggers include these additional fields:
PropertyTypeDescription
Billing Attempt StatusStringSUCCESS or FAILURE
Billing Attempt IDNumberShopify billing attempt ID
Billing DateDateTimeScheduled billing date (ISO 8601)
Billing Attempt TimeDateTimeActual attempt timestamp (ISO 8601)
Billing Attempt CountNumberHow many times billing has been attempted for this cycle
The Membership Billing Success trigger also includes:
PropertyTypeDescription
order_idNumberShopify order ID created by the successful renewal
Recurring Order IDNumberSame as order_id
Recurring Order NameStringOrder name (e.g., “#1002”)

Example workflows

Trigger: Membership CreatedAction: Klaviyo / Omnisend / Shopify Email — send “Welcome to the membership” emailUse Customer Email as the recipient and Membership Selling Plan Name to personalize the plan name in the email body.
Trigger: Membership UpdatedCondition: Membership Selling Plan Name contains "Gold"Action: Shopify — Add customer tag gold-memberThis pattern lets you apply tier-specific tags automatically as members upgrade or switch plans.
Trigger: Membership Billing FailureCondition: Billing Attempt Count equals 1 (first failure only)Action: Klaviyo — Trigger “Update Payment Method” flowPass Customer Email and Membership ID as variables to the email template.
Trigger: Membership CancelledAction 1: Shopify — Add customer tag membership-cancelledAction 2: Klaviyo — Send “We’re sorry to see you go” email with a win-back offer
Trigger: Membership Billing SuccessAction: Salesforce / HubSpot (via Flow connector) — Log renewal eventUse order_id, Customer Email, and Membership Selling Plan Name as the data payload.
Trigger: Membership ExpiredAction: Slack — Send message to #membership-churn channelInclude Customer Display Name, Customer Email, and Membership Selling Plan Name in the message body.

Notes

  • Imported membership contracts do not fire membership-created. Only contracts created through the Shopify checkout flow trigger this event.
  • Flow integration must be enabled in Settings → Integrations before any triggers will fire.
  • All Flow trigger events appear in the membership Activity Log with source SYSTEM_EVENT.