Cancel subscription

post

https://api.loopsubscriptions.com/admin/2026-04/subscription/{subscriptionId}/cancel

This endpoint allows you to cancel an active or paused subscription, stopping all future billing and deliveries permanently or until reactivated by the customer or merchant.

Token scope - Read & write subscription contracts

Rate limit - Global pool (i.e. 50 requests per second per domain)

Path param explained :

subscriptionId Id of the subscription. This can be passed in the following format :
- {id} - where id is the Loop internal id of the subscription contract. This is the default path param format.
- loop-{id} - where id is the Loop internal id of the subscription contract.
- shopify-${id} - Where id is the shopifySubscriptionId of the subscription contract.

Path Params

subscriptionId

int32

required

The unique identifier of the subscription in Loop.

Body Params

cancellationFlowId

int32

required

Identifier for the cancellation flow selected by the customer or merchant. This is used to track the cancellation analytics.

comment

string

Optional text field used to capture additional notes or remarks provided by the customer during the cancellation of the subscription.

notifyCustomer

boolean

Optional parameter that determines whether a cancellation email should be sent to the customer. Defaults to true if not specified.

markForCancellation

boolean

Applicable only for prepaid subscriptions. If set to true, the subscription will be marked for cancellation and will cancel after all orders in the current prepaid cycle are fulfilled. If set to false, the subscription will be cancelled immediately.

Responses

Path param explained :

200Subscription cancelled successfully

401Invalid header token

404Subscription not found