2025-11-17 — Subscriptions API Breaking Change
Breaking change coming December 3, 2025: List Customers endpoint address fields will change type.
26 posts tagged with "Subscriptions"
View All Tags2025-06-11 — Add Discount Code Endpoints
Developers now have a simpler path to modifying discount codes on Subscriptions.
2024-09-17 — Add Dynamic Discounts
Subscription Groups support Dynamic Discount rules.
2024-08-29 — Add Convertible Adjustments Endpoints
Developers now have the ability to configure automatic product conversions when subscriptions are created from checkout.
2024-07-16 — Add a new subscription adjustment action
The Subscriptions API now supports a new type of adjustment action - apply price to a line item.
2023-07-14 — Add update_line_item_quantity Subscription Adjustment type
Developers can now update line item quantity in future orders as one-time or ongoing modifications, or on a customized schedule of their own.
2023-07-10 — Add latest parameter to List Selection Options endpoint
The List Selection Options endpoint now uses the optional latest query parameter to return the latest subscription group that a product was added to.
2023-06-20 — Additional information about Payment Methods
The Get Payment Method endpoint now returns additional information, such as customer's name and billing address, when this data is available.
2023-06-12 — New Failure Code for Subscriptions
For Subscriptions endpoints, the new out_of_stock_product error code is now available in the last_failure_code field when a recurrence order cannot be placed due to missing products on stock.
2023-05-18 — Subscriptions Future Order API improvements
To support the recent introduction of our Subscription Adjustment API, several improvements have been made to the Future Order endpoints of Subscriptions.
2023-05-18 — Subscription Adjustment API
Developers now have the ability to add line items to future orders as one-time or ongoing modifications, or on a customized schedule of their own.
2023-05-01 — Price is optional when updating Subscription Line Items
When updating a Subscription Line Item, the price field is now optional.
2023-03-09 — Add Event-Actor-Type header to webhook callbacks
Callbacks to webhooks registered using the Create Webhook Subscription endpoint now contain a header called Event-Actor-Type. This header indicates the type of user that triggered the webhook event.
2023-03-02 — Add new subscriptions webhook topic for line items added
A new webhook topic is now available for subscription line items added. Add this webhook via the Create Webhook Subscription endpoint.
2023-02-07 — Add address deleted_at
The subscriptions shipping_address and billing_address objects now contain a field called deleted_at.
2023-02-01 — Add subscription order_count
The subscription now contains a field called order_count. This field gives the current count of orders created for a subscription.
2023-01-17 — Add endpoint for creating subscription line items
Adds the Create Line Items endpoint.
2022-10-31 — Add endpoint for updating prepaid metadata
Adds the Update Line Item Prepaid Metadata endpoint.
2022-10-25 — Add endpoint for creating line item attributes
Adds the Create Line Item Attributes endpoint.
2022-10-19 — Add plugin_event_failed code to Subscriptions last_failure_code
Adds a plugin_event_failed failure code to the possible list of last failure codes in the Subscription entity of the Subscriptions API.
2022-10-18 — Add endpoint for prepaid subscriptions
Adds the Create Line Item Prepaid Metadata endpoint to the Subscriptions API. This allows API users to convert subscriptions to prepaid.
2022-09-16 — Add additional failure codes to Subscription entity
Adds a few new failure codes to the Subscription entity of the Subscriptions API
2022-09-13 — Add last_failure fields to Subscription entity
Adds three optional fields to the Subscription entity of the Subscriptions API
2022-09-01 — Discount code support for Create Subscription endpoint
Adds support for the subscription.discount_code field in the payload of the Create Subscription endpoint of the Subscriptions API.
2022-09-01 — Add placed_at to Subscription
Adds a new placed_at field to the Subscription entity of the Subscriptions API.
2022-07-21 — Subscription order note
Add an order_note field to the Subscriptions object. This feature ensures that the customer order note added at the time of the initial order is carried through to recurring orders and that it can be updated via the API.
note
This field is supported on stores using Shopify Checkout only.