Build HSA/FSA-Eligible Collections
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.
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
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 with status: hsa_fsa_eligible or status: eligible_with_lmn,
mark that product in your catalog as Truemed-eligible. When you receive status: ineligible,
remove that tag.
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 endpoint with the item’s SKU.
