> This page is for version v1 (default).
> For other versions, use one of these documentation indexes:
> - v1 (default): https://developers.truemed.com/v-1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.truemed.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.truemed.com/_mcp/server.

# Build HSA/FSA-eligible collections

> How to use Truemed's eligibility data to build a dedicated HSA/FSA-eligible collection on your storefront.

Once Truemed has classified your SKUs, you can use that eligibility data to build dedicated
HSA/FSA collections on your storefront. A curated "Shop with your HSA/FSA" collection lowers
friction for health-conscious shoppers and surfaces products they may not have known were covered.

> **Note**
>
> On Shopify, you don't need to build this yourself. Truemed writes each variant's eligibility status
> into your store, and you can use it directly as a collection condition. See
> [HSA/FSA eligible collections](/marketing/widgets/eligible-product-collections-and-badges).

## Why this matters

Customers often don't know which products qualify for HSA/FSA spending. A dedicated collection
or filtered category page gives them a clear starting point—and a reason to spend their pre-tax
dollars with you before the benefit year ends.

Common use cases:

* A "Shop HSA/FSA Eligible" collection page or landing page
* A storefront filter ("Show only HSA/FSA eligible items")
* Email or marketing campaigns targeting HSA/FSA holders near year-end

## How to build it

### 1. Listen for eligibility updates

Subscribe to the [`product_catalog_item_eligibility_updated`](/api-reference/product-catalog/item-eligibility-updated-webhook)
webhook. Each time an item's status changes, Truemed will send a payload with the SKU and its
new eligibility status.

Store the eligibility status alongside each product in your system (e.g., in a product
metafield, database column, or tag).

### 2. Tag eligible products

When you receive a webhook where the item's `eligibility` is `eligible` or `eligible_with_lmn`,
mark that product in your catalog as Truemed-eligible. When you receive `eligibility: ineligible`,
remove that tag.

The item lives at `data.data.object` on signed deliveries and at `data.object` on unsigned ones. See the
[webhook reference](/api-reference/product-catalog/item-eligibility-updated-webhook) for the full body.

### 3. Build your collection

Use the eligibility tags to drive a filtered collection page, a storefront segment, or a
marketing audience—whatever the platform supports.

### 4. Keep it up to date

Eligibility can change as Truemed refines its classifications. Continue listening to the
webhook and updating your tags in real time so your collection always reflects the current state.

## Checking item status on demand

If you need to look up a specific product's current status outside of a webhook (e.g., during
a catalog sync or backfill), use the
[`get_catalog_item`](/api-reference/product-catalog/get-item-detail) endpoint with the item's SKU.