Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.henrylabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

April 22, 2026
Cart
v1.5.0
  • Cart items now accept an optional affiliateProductLink field on cart.create, cart.item.add, and cart.item.update. Pass your partner tracking URL and Henry will use it for fulfillment while keeping the original link as the canonical product reference.
  • affiliateProductLink is also returned on purchase responses (cart.checkout.pollPurchase) and order list items, so you can reconcile attribution end-to-end.
  • If affiliateProductLink is omitted, Henry falls back to link - existing integrations are unaffected.
  • Available in @henrylabs/sdk@1.5.0.
April 17, 2026
Cart
v1.4.0

Cart Fetch

  • Added cart.fetch(cartId, { buyer? }) to retrieve a single cart by ID and optionally prefill buyer details in the returned checkoutUrl for hosted checkout.
  • Available in @henrylabs/sdk@1.4.0.
April 14, 2026
ProductsCart
v1.3.0

Product Discovery

  • products.search now supports merchant-scoped search via type: 'merchant', alongside existing text and image search.
  • mode: 'sync' added across products.search, products.details, and cart.checkout.purchase - wait up to 30s for results inline instead of polling.

Cart

  • cart.create settings now accept the full settings.events trigger model, including webhook, email, points, and tier actions with optional conditionals.
  • Released in @henrylabs/sdk@1.3.0.
April 13, 2026
SDK
v1.2.1

SDK

March 30, 2026
SDK
v1.1.2

SDK

March 20, 2026
SDKClient SDK
v1.0.0

Henry SDK v1

  • Shipped @henrylabs/sdk@1.0.0 - the stable TypeScript server SDK for product discovery, universal cart, checkout, and orders.
  • Cart creation now returns a ready-to-use checkoutUrl alongside cartId - no separate session step needed.
  • Unified async pattern (refId + poll*) across product search, product details, and headless checkout, with a new mode: 'sync' option to wait up to 30s inline.

Client SDK (Browser)

  • Introduced @henrylabs/js@1.0.0 - a framework-agnostic browser SDK for embedding checkout directly into your frontend.
  • Henry.createCheckoutElement(...) drops a buy-now button and modal onto any page with display modes for full, compact, comfortable, bubble, and direct.
  • Henry.createCardElement(...) renders an isolated iframe for PCI-safe card capture and returns a cardToken for server-side use with headless checkout.
February 09, 2026
v0.25.0

MCP Improvements

  • Added initial server instructions for MCP.

Bug Fixes

  • Fixed a memory leak related to abort signals in the client.
  • Fixed an issue where abort listeners were removed too early.
  • MCP no longer falls back to baseUrl when the environment variable is set.
  • Correctly defined the false enum type.
January 26, 2026
v0.24.0

Improvements

  • Merged staging into main.

Bug Fixes

  • Fixed MCP installation instructions for remote servers.
  • MCP now allows fallback behavior for required environment variables.
January 12, 2026
ProductsMCP
v0.22.1

Transaction Fee on Checkout

  • Charge users a transaction fee on checkout. This fee is applied to the total order amount. Currently for Enterprise customers only.

Saved Shipping Addresses for Guest Users

  • Now guest users can save multiple shipping addresses

Checkout MCP

  • Bug fixes and performance improvements
January 5, 2026
Products
v0.22.0

Concurrent Enrich & Variant Check Requests

  • Enrich and check variants in parallel, with up to 50 concurrent requests.
  • Now possible to batch enrich and check variants

Improved Product Search Filtering

  • Updated product text and image search parameters to include additional filters and sorting options.
  • Filter by brand, merchant, min/max price, sale status, and more.
  • Scope searches to country and region (Ex. us, Austin, Texas)
  • Sort results by relevance and price
December 29, 2025
CartCheckoutProducts
v0.22.0

Multi-Cart Checkouts

  • Checkout multiple items at once with our multi-cart checkout flow. Multi-cart checkout will work automatically without any code changes.
  • Users can add items to cart from any supported merchant, and they will be checked out together. Adding multiple items in a single request is currently experimental.

Save Additional Addresses & Payment Methods

  • Save additional address and payment methods for your users, making it easier than ever to place orders.
  • This feature is released along side with a visual refresh of our hosted checkout page.

Enrich Top-k Products

  • Now automatically enrich top-k products returned from Text Product and Image Product searches.
December 22, 2025
CheckoutOrders
v0.21.1

Custom Themes

  • In addition to adding your brand assets to emails and our hosted checkout page, you can now customize the color scheme of our checkout page and purchase confirmation email.

Order Management

  • Query all orders for a given user using our new Order List endpoint
December 15, 2025
ProductsCheckoutOrders
v0.18.0

Product Discovery

  • Introducing reverse image search. Search through 2b+ SKUs, enabling more intuitive and visual shopping experiences in your app.

Hosted Checkout

  • Added iFrame support with cookie-free checkout. Embed the checkout experience directly in your app without worrying about third-party cookie restrictions or cross-origin limitations.

Programmatic Email Inbox

  • All transactional emails, order confirmations, shipping updates, newsletters, and more are now captured and stored.
  • Query and access your users’ merchant emails programmatically, giving you full control to build custom order tracking, notifications, and support experiences.
December 8, 2025
CheckoutProducts
v0.17.0

Global Region Support

  • Now, allow users from anywhere in the world to route checkouts through Henry Labs
  • Initial support is for EU and UK regions in addition to existing US support. Wider global support coming soon

Product Enrichment Endpoints

  • Introduced Product Enrichment Endpoints, allowing you to get product price, variant information, stock availability for a product given its link
  • Endpoint is currently Experimental, with availability reserved for Plus Plan customers and above

API Playground

  • Added new API Playground for Sandbox and Production environments. Get started here
  • Intended for developers trying out our APIs. It’s recommended to save the Directory link to keep your documentation up to date with our latest API changes
December 1, 2025
Products
v0.15.0

Basic, Standard, and Plus Plans

  • Rolled out self-serve subscription plans for customers of all sizes.
  • No matter what stage your business is in, Henry Labs has a plan for you. Build embedded shopping experiences in your app today.

AI Agent in Quickstart Demo

  • Added AI Agent to Quickstart Demo. Try it out here.
  • This agent is powered by Henry Shopping MCP
  • The agent code is open source and available here
November 24, 2025
Orders
v0.14.0

Enterprise Pro Plan

  • Introduced Enterprise Pro Plan, with full access to headless checkout, bespoke API features, 24/7 support, and more. For more information contact support@henrylabs.ai.

Email Whitelabeling

  • Email domain whitelabeling has been rolled out in production. Route merchant emails through your own domain, allowing you to control the end-to-end customer experience without comprimising user trust or ever managing returns.
November 17, 2025
CheckoutProductsWallet
v0.13.0

Checkout & Payment Experience

  • Visual refresh. Updated payment card designs, icons, dropdowns, and more.
  • Improved UI for CVV updates, payment method management, and shipping address autocomplete.

Product Search & Quickstart Demo

  • Expanded product details API to include reviews, video, stars, similar products, and related searches.
  • Quickstart Demo now renders new product details on demo.henrylabs.ai.

Hosted Checkout Whitelabeling

  • Add your brand logo to the hosted checkout modal.
November 10, 2025
OrdersCheckout
v0.12.0

Henry Managed Accounts

  • Introducing Henry Managed Accounts. Unlock the power of user merchant accounts fully managed by Henry Labs.
  • Track post-order states (shipping, returns, etc) so you can provide your customers real-time order updates.
  • Whitelabel merchant emails, build trust with your customers, and have full control over the E2E user experience.
  • Managed accounts are rolling out to all supported merchants

Hosted Checkout

  • Hosted checkout now supports updating CVV at point of checkout
November 3, 2025
Products
v0.11.0

Product Discovery

  • The result of variant checks is now reflected in our Hosted Checkout page

Henry Shopping SDK (TypeScript)

  • Introducing the Henry Shopping SDK, making it easier than ever to start building (Python SDK coming soon)

Henry MCP Server

  • Add an end-to-end embedded commerce stack to your agent application with less than 10 lines of code
October 23, 2025
CartWalletProducts
v0.10.0

Universal Cart

  • POST /cart/items now accepts affiliateProductLink, letting you pass through your partner tracking links end-to-end.
  • Added the optional checkVariantAvailability parameter so carts can auto-check the selected variant’s inventory when items are added. Feature is currently experimental.
  • Introduced a “blocklist” mode that allows any product to be added to cart and checked out except for those explicitly blocked.

Wallet

  • Added guest card collection mode for /wallet/cart-collect

Product Discovery

  • Released experiemental variant check endpoints. Use them to check real time stock availability of variants.

Henry Dashboard

  • Added staging vs. production environment flag to dashboard.

Miscellaneous

  • Added unified generated documentation at api.[sandbox].henrylabs.ai/docs