API Reference

Activity logs - keys explained

Below are all the unique keys that are available in the activity logs object.

Please note: Additional keys may be introduced over time as they depend on Loop’s feature set. New features will automatically extend the response with corresponding keys.


Subscription lifecycle

  • subscription_created - A new subscription was created for the customer.
  • subscription_paused - An active subscription was paused until further action or a set date.
  • subscription_resumed - A paused subscription was resumed.
  • subscription_reactivated - A previously cancelled/expired subscription was reactivated.
  • subscription_cancelled - The subscription was cancelled and will not renew.
  • subscription_expired - The subscription reached its end date/term and expired.
  • marked_for_cancellation - Subscription flagged to cancel at the end of the current term/cycle.
  • subscription_merged - Two or more subscriptions were merged into a single subscription.
  • billing_policy_updated - Billing cadence/terms (interval, charge timing) for the subscription were changed.
  • order_schedule_preferences - Customer’s schedule preferences (interval/day/date rules) were updated.

Payment & billing

  • payment_attempted - A payment attempt was initiated for a subscription order.
  • payment_attempt_failed - A payment attempt failed (non-final).
  • payment_failed - The charge failed for the order (counted as a failure event).
  • payment_failed_retry - A retry attempt failed during the dunning sequence.
  • payment_failed_last_retry - Final retry failed; dunning sequence ended without success.
  • payment_method_added - A new primary payment method was added to the customer profile.
  • payment_method_updated - Existing payment method details were updated.
  • payment_method_changed - The active payment method on a subscription was switched to another.
  • payment_method_update_requested - We requested the customer to update their payment method (e.g., via link or notification).
  • backup_payment_method_created - A backup card was added for use if the primary fails.
  • backup_payment_method_updated - The backup card’s details were updated.
  • backup_payment_method_removed - The backup card was detached from the subscription/customer.
  • backup_payment_method_deleted - The backup card record was permanently deleted.
  • prepaidCreditsAdjusted - Prepaid balance/credits were added, removed, or reconciled.

Orders & scheduling

  • order_created - A subscription order was generated.
  • order_skipped - The upcoming order was skipped.
  • order_partially_skipped - Only part of the order (some lines) was skipped.
  • order_unskipped - A previously skipped order was restored.
  • one_order_rescheduled - A single upcoming order was moved to a new date.
  • order_rescheduled - One or more future orders were rescheduled.
  • order_delayed - The upcoming order was delayed to a later date.
  • order_gifted_instead_of_skip - Order was converted into a gift (sent to another recipient) rather than being skipped.

Shipping & delivery

  • shipping_address_updated - Shipping address for the subscription/order was updated.
  • shipping_price_updated - Shipping rate/price for the order/subscription changed.
  • delivery_method_updated - Delivery method (shipping, local delivery, pickup) was changed.
  • local_delivery_address_updated - Local delivery address was updated.
  • local_delivery_details_updated - Local delivery instructions/time window updated.
  • pickup_location_updated - Pickup location was changed.

Products (line items)

  • product_added_subscription - A product was added to the subscription.
  • product_removed_subscription - A product was removed from the subscription.
  • product_added_onetime - A one-time product was added to an upcoming order.
  • product_removed_onetime - A one-time product was removed from an upcoming order.
  • product_price_updated - The price of a product in the subscription/order was updated.
  • product_qty_changed - Quantity of a product line was changed.
  • line_item_variant_updated - Variant/SKU on a line item was changed.
  • line_properties_updated - Custom properties on a line item were updated.
  • product_swapped - A product in the subscription was swapped for another.
  • subscription_sku_upgrade - Product on the subscription was upgraded to a higher SKU/tier.
  • subscription_sku_upgrade_frequency_change - Along with a SKU change, the billing/shipping frequency was updated.

Bundles

  • bundle_added_subscription - A bundle was added to the subscription.
  • bundle_removed_subscription - A bundle was removed from the subscription.
  • bundle_added_onetime - A bundle was added as a one-time item to an order.
  • bundle_removed_onetime - A one-time bundle was removed from an order.
  • bundle_updated - Contents/settings of a bundle were updated.
  • bundle_qty_changed - Quantity of a bundle was changed.
  • bundle_swapped - One bundle was swapped for another.
  • unbundle_items - Bundle was broken into individual line items.
  • line_to_preset_bundle_swap - Individual line was converted into a preset bundle.
  • preset_bundle_to_line_swap - Preset bundle was converted back into individual line(s).

Discounts & incentives

  • discount_code_added - A discount/promo code was applied.
  • discount_code_removed - A discount/promo code was removed.
  • manual_discount_added - A manual/agent-applied discount was added.
  • manual_discount_removed - A manual discount was removed.
  • free_shipping_discount - Free-shipping benefit was applied.
  • cancellation_offers - A save/retention offer (discount, gift, alternate product) was presented during cancel flow.

Streaks & rewards

  • streak_enrolled - Customer enrolled in a streak/loyalty sequence.
  • streak_completed - Customer completed the required sequence of orders.
  • streak_reward_unable_to_add - System could not apply the intended streak reward to the order/subscription.

Customer communications & auth

  • sent_login_link - A passwordless/login link was sent to the customer.
  • customer_email_notification - An email notification related to the subscription/order was sent.

Preferences & metadata

  • update_custom_attributes - Custom attributes on the customer/subscription were updated.
  • update_order_note - The order note or internal memo was added/updated.

Flows & automation

  • flow_triggered - An automated Flow/Journey was triggered for this customer/subscription context.