Cancel a membership contract

Permanently cancels an active membership contract in Shopify. This operation stops all future billing and marks the membership as CANCELLED.

Full behavior, validation rules, and side effects

Important Notes:

• Permanent Action: Cancellation cannot be undone. A new membership must be created to re-subscribe.
• Email Notification: Cancellation email is automatically sent to the customer
• Activity Logging: Cancellation is logged with reason/feedback for analytics
• Immediate Effect: No future billing attempts will be made

Customer Portal Restrictions: When called from customer portal, additional validations apply:

• Minimum Cycles: Cannot cancel if membership hasn’t completed minimum required billing cycles
• Frozen Memberships: Cannot cancel memberships that are frozen until min cycle completion
• Attribute-Based Limits: Respects any custom attribute-based cancellation restrictions

Cancellation Feedback:

• Optional cancellationFeedback parameter to capture why customer is cancelling
• Common values: ‘TOO_EXPENSIVE’, ‘NO_LONGER_NEEDED’, ‘SWITCHING_TO_COMPETITOR’, ‘OTHER’
• Helps merchants understand churn reasons

Use Cases:

• Customer requests to cancel their membership
• Merchant manually cancels membership (e.g., payment issues, customer request)
• Automated cancellation after max cycles reached

Authentication: Requires authenticated shop user or customer portal token

DELETE /memberships/cp/api/subscription-contracts/{id}

Cancel a membership contract

cURL

curl --request DELETE \
  --url https://www.myshop.com/apps/memberships/cp/api/subscription-contracts/{id}

204

Path Parameters

id · integer<int64> · required

Membership contract ID to cancel

Query Parameters

cancellationFeedback · string

Optional cancellation reason/feedback from customer

cancellationNote · string

Optional cancellation note with additional details

Response

204

Membership successfully cancelled (no content returned). Cancellation email sent to customer.