2026-01-05 — Subscriptions API Breaking Change

Breaking change related to customers' addresses coming February 1, 2026.

We are excited to announce a significant update to how subscription addresses are handled within our platform. These changes are designed to provide a cleaner, faster user interface and ensure more reliable address changes for your subscribers.

Currently, syncing addresses directly with Shopify can occasionally lead to unintended behavior — such as an update to a default address accidentally impacting unrelated subscriptions. To solve this, we are moving to a model where each subscription maintains its own independent shipping and billing address.

Key Benefits

• More Reliable Address Updates: By decoupling subscription addresses from the general Shopify customer address book, updates are now isolated. Changing an address for one subscription will no longer unintentionally affect others.
• A Better Interface: We are streamlining the Customer Portal and App Admin by removing the legacy Address dropdown menu. This results in a simplified, less cluttered experience for both merchants and customers.
• Data Integrity: Moving forward, all addresses stored in our database will be native to our platform (Source: bold), eliminating synchronization conflicts with Shopify platform data (Source: platform).

Technical Implementation Guide

For developers integrating with our API, this change involves a shift in how you retrieve and update addresses.

How to Retrieve a Shipping Address

You should no longer rely on the Customers endpoints for address data. Instead, access the address directly through the Subscription object. Use the GET Subscription endpoint to retrieve the shipping_address object directly.

How to Update a Shipping Address

To update an address, you must identify the specific address attached to the subscription.

1. Call the GET Subscription endpoint.
2. Extract the shipping_address_id.
3. Use that ID as the address_id in a PUT Update Customer Address request.
4. Update the Subscription so the address change is updated on the Shopify contract with PATCH Partial Update Subscription updating the shipping_address_id to the address_id that was just updated.

Retrieving a List of Customer Addresses

As we are disabling the sync of generic Shopify platform addresses, our API will no longer return the full list of a customer’s Shopify addresses.

Action Required: If your application requires a full list of a customer’s saved addresses from Shopify, please query the Shopify API directly.

API Deprecations and Breaking Changes

To support this architecture, specific fields in the Customer APIs will be deprecated. The following endpoints will now return empty arrays for address-related fields. Please ensure your applications handle these responses correctly.

• Subscriptions API:
  • GET Customer:
    • addresses will return []
    • default_address will return null
  • GET List Customers:
    • addresses will return []
    • default_address will return null
  • GET List Customer Addresses:
    • customer_addresses will return []
• Customers API:
  • GET List Customers:
    • addresses will return []
    • default_address will return null
  • GET Customer by ID:
    • addresses will return []
    • default_address will return null
  • GET Customer by Platform ID:
    • addresses will return []
    • default_address will return null
  • GET List Customer Addresses:
    • This endpoint is deprecated
    • It will return {"addresses": []}

Note on Default Addresses

Default address attributes will remain on endpoints that currently support them. However, the value will always be returned as null.