December 22, 2025

API, B2B, and Catalyst Documentation Updates

This update includes improvements across our core APIs, integrations, B2B tooling, and Catalyst storefront experience. On the API side, we’ve improved catalog accuracy, expanded translation support for product filters and options via GraphQL, clarified tax rounding strategies, and updated Store Information docs to the v3 endpoint. For integrations, we’ve added clearer guidance on generating secure JWT tokens and navigating the app submission review process. B2B developers get new Storefront GraphQL docs, clearer behavior for the B2B Orders API and order migration, plus new Buyer Portal setup guides. And for Catalyst, we’ve introduced a deployment overview and a new beta experience for syncing products to Makeswift and surfacing them as routes.

API

Introduced faster, batch-capable record creation in Price List API docs

Improved product options API docs for accuracy

Added rounding strategy option for tax providers

Added  missing product_description model

Update store information metafields documentation to use v3 API endpoint

Product filters are now able to be translated with the GraphQL Admin API

  • Product Option Translations

GraphQL Translations API now supports Product Options

Integrations

Documented how to generate secure JWT tokens for integrations

Adding additional details of the app review submission process

B2B

Added documentation for B2B Storefront GraphQL API

This update discloses the default filtering behaviour of the B2B “Get All Orders” API, which returns only the last year of orders if no filter parameters are provided

The Create a Company User S2S endpoint information now indicates what happens to existing orders from previous B2C customers converted to B2B Company users

We’ve created new guides for setting up Buyer Portal covering native Stencil, Headless, and Catalyst deployment with the default build when possible and custom Buyer Portal in any case

Catalyst

Added a deployment overview doc for a catalyst storefront

Now in beta, you can sync your products to your Makeswift Site and view them as routes in your Makeswift Pages Tab

Introduced faster, batch-capable record creation in Price List API docs

Improved product options API docs for accuracy

Added rounding strategy option for tax providers

Added  missing product_description model

Update store information metafields documentation to use v3 API endpoint

Product filters are now able to be translated with the GraphQL Admin API

  • Product Option Translations

GraphQL Translations API now supports Product Options

Integrations

Documented how to generate secure JWT tokens for integrations

Added additional details of the app review submission process

B2B

Added documentation for B2B Storefront GraphQL API

This update discloses the default filtering behaviour of the B2B “Get All Orders” API, which returns only the last year of orders if no filter parameters are provided

The Create a Company User S2S endpoint information now indicates what happens to existing orders from previous B2C customers converted to B2B Company users

We’ve created new guides for setting up Buyer Portal covering native Stencil, Headless, and Catalyst deployment with the default build when possible and custom Buyer Portal in any case

Catalyst

Added a deployment overview doc for a catalyst storefront

Now in beta, you can sync your products to your Makeswift Site and view them as routes in your Makeswift Pages Tab