Skip to main content

Storefront API

Updated April 27, 2026

Build a fully custom shopping experience using Fourthwall as the backend for your products and cart

The Fourthwall Storefront API lets you use your Fourthwall shop as a headless commerce backend. You control the frontend entirely — your own design, framework, and domain — while Fourthwall handles products, inventory, and checkout. The API returns product data as JSON and handles cart actions so you can build any experience you want.

Get your API credentials​

To use the Storefront API, retrieve your credentials from the developer settings.

  1. Go to Settings > For Developers > Headless in your Fourthwall dashboard.
  2. Copy your Storefront API token.

Include the token in your API requests using the Authorization header:

Authorization: Bearer YOUR_STOREFRONT_TOKEN

What the API provides​

The Storefront API exposes two core capabilities:

Product data. Query your published product catalog. Retrieve product lists, individual products, variants, images, prices, and availability as JSON. Use this data to render your custom product pages.

Cart actions. Create carts, add and remove items, and retrieve cart totals. When a customer is ready to check out, redirect them to the Fourthwall-hosted checkout using the cart token. Fourthwall handles payment, order creation, and fulfillment from that point.

Starter template: Vercel Commerce​

To get started quickly, use the official Vercel Commerce starter template built for Fourthwall:

github.com/FourthwallHQ/vercel-commerce

The template is a Next.js storefront pre-wired to the Fourthwall Storefront API. It includes product listing pages, product detail pages, cart functionality, and checkout redirect. Clone it, add your Storefront API token, and deploy to Vercel to have a working custom storefront in minutes.

Use cases​

  • Custom brand experiences. Build a storefront that matches your visual identity without the constraints of a template-based shop.
  • Content-first sites. Embed shop functionality inside an existing website or blog without migrating your content.
  • Mobile apps. Use the Storefront API as the backend for a native iOS or Android shopping experience.
  • Unique interaction patterns. Build product discovery experiences — filters, lookbooks, interactive previews — that go beyond what standard shop templates support.

Limitations​

  • The Storefront API provides read access to published products only. You cannot create or modify products through the API.
  • Checkout is handled by Fourthwall. You redirect customers to the Fourthwall checkout page using a cart token. You cannot build a custom checkout flow.
  • The API does not expose order history, account management, or supporter data.

Frequently asked questions​

Do I need coding experience to use this?​

Yes. The Storefront API is intended for developers. Building a custom storefront requires front-end development skills and familiarity with REST APIs or GraphQL-style data fetching. The Vercel Commerce starter template reduces setup time significantly.

Can I use any front-end framework?​

Yes. The API returns JSON, so you can build your storefront with any framework: Next.js, Nuxt, SvelteKit, plain HTML, or a mobile app. The Vercel Commerce template uses Next.js, but it is not required.

Where is the full API reference?​

The full Storefront API reference is available in the developer settings under Settings > For Developers > Headless in your Fourthwall dashboard.

Does this affect my existing Fourthwall shop?​

No. Your standard Fourthwall shop continues to work as normal. The Storefront API is an additional layer that lets you build a separate custom frontend — it does not replace or modify your existing shop.

If you have any questions, do not hesitate to contact us at support@fourthwall.com.

Was this helpful?