Using Submarine with Shopify Flow

Rather than building functionality like email notifications, webhook triggers, or custom app-to-app integrations into the platform, Submarine instead offers a comprehensive Shopify Flow integration. This gives merchants the flexibility to connect Submarine to their existing systems and use Flow to build custom workflow logic - out of the box.

For example, a merchant already managing customer email templates in Klaviyo can connect the Upcoming Subscription Order trigger from Submarine to the Event action in Klaviyo, and deliver an email notification to the customer ahead of their next subscription order being placed. This helps keep customer data and custom email template management in the one place, rather than siloing it inside Submarine.

Going the other way, a merchant using Loyalty Lion may want to reward loyal customers with credit on their next subscription order. To do this, they could connect the Customer moved into “Loyal” segment trigger from Loyalty Lion to the Adjust subscription credit action (beta) in Submarine.

Triggers such as notifications are configurable based on merchant needs - you can see the list of available configurations and their default values in Submarine subscription configuration options.

Flow triggers

Payment action failed

A payment action (for example, authorisation or capture) failed to complete successfully.

Name	Type	Description
Customer email	Email	The email address of the customer.
Payment amount	Number	The amount of the attempted payment (in cents).
Action URL	URL	A URL the customer can follow to take action to address the payment issue.
Error message	String	Any error message returned from the payment processor.

Upcoming subscription order

A subscription order is upcoming for a customer.

Name	Type	Description
Customer email	Email	The email address of the customer.
Scheduled at	String	The date and time the order is scheduled to be placed (in ISO8601 format).
Total price	Number	The total price of the upcoming order (in cents).
Action URL	URL	A URL the customer can follow to review their order.

Customer first subscription

A customer created their first subscription.

Name	Type	Description
Customer email	email	The email address of the customer.

Upcoming card expiry

A stored credit card is expiring soon.

Name	Type	Description
Customer	customer
Type of card	string	The brand of credit card (e.g. "visa").
Last four digits	string	Last four digits of the credit card.
Expiry date	string	The expiry date of the credit card (in ISO8601 format).
Action URL	url	A URL the customer can follow to update their payment details.

Items removed from subscription

One or more items have been removed from a subscription, independently of any customer activity (e.g. a subscription product has been unpublished or deleted).

Name	Type	Description
Customer	customer
Reason	string	The reason for the removal.
Total price	number	The revised price of the subscription order (in cents).
Variant IDs	string	A comma-separated list of Shopify variant IDs that were removed.
Action URL	url	A URL the customer can follow to review the subscription.

Subscription cancelled

A subscription has been cancelled by Submarine, independently of any customer activity (e.g. all subscription products have been unpublished or deleted).

Name	Type	Description
Customer	customer
Reason	string	The reason for the cancellation.
Reason detail	string	Additional information about the reason for the status change.
Action URL	url	A URL the customer can follow to review the subscription.

Subscription status changed

The status of a subscription has been changed, by the customer, the merchant or Submarine.

Name	Type	Description
Customer	customer
Subscription ID	string	The Submarine subscription ID.
Reason	string	The reason for the change in status.
Reason detail	string	Additional information about the reason for the status change.
Previous status	string	The previous status of the subscription, e.g. 'active'.
Updated status	string	The updated status of the subscription, e.g. 'paused'.
Active subscription count	number	The current number of active subscriptions the customer has.
Action URL	url	A URL the customer can follow to review the subscription.

Subscription-item status changed

The status of an individual subscription item has been changed, by the customer, the merchant or Submarine.

Name	Type	Description
Customer	customer
Product	product
Variant ID	string	The ID of the Shopify variant.
SKU	string	The SKU of the Shopify variant
Reason	string	The reason for the change in status.
Reason detail	string	Additional information about the reason for the status change.
Previous status	string	The previous status of the subscription.
Updated status	string	The updated status of the subscription.
Active subscription count	number	The current number of active subscriptions the customer has for the item.
Action URL	url	A URL the customer can follow to review their subscriptions.

Flow actions

Update customer subscription status

Set the status of all of a customer's active subscriptions.

Name	Type	Description
customer_email	email	The email address of the customer.
subscription_status	short_text	Can be either "paused" or "cancelled".

For more information on how Submarine works together with Shopify Flow, including flow build examples, see Submarine and Shopify Flow.