---
title: Storefront API
shortDescription: Use the Fourthwall Storefront API to build a fully custom headless storefront powered by your Fourthwall product catalog and cart.
articleType: Reference
primaryTopic: storefront-api
categories:
  - Developer Tools
  - Integrations
tags:
  - storefront-api
  - headless
  - custom-storefront
  - developer
  - api
  - vercel-commerce
  - headless-commerce
tasks:
  - Get Storefront API credentials from your dashboard
  - Query products using the Storefront API
  - Add items to cart using the Storefront API
  - Deploy a custom storefront using the Vercel Commerce starter template
  - Build a headless storefront with Fourthwall
terms:
  - fourthwall storefront api
  - headless storefront fourthwall
  - custom storefront fourthwall
  - fourthwall headless commerce
  - vercel commerce fourthwall
  - storefront api credentials
  - fourthwall api headless
  - build custom store fourthwall
  - product data api fourthwall
  - cart api fourthwall
  - headless ecommerce fourthwall
labels:
  - storefront-api
  - headless
  - developer-tools
contextString: Available to all Fourthwall creators. Requires API credentials from Dashboard > Settings > For Developers > Headless. Intended for developers building custom storefronts.
breadcrumbPath: "Manage my shop > Apps, features, and integrations > Storefront API for Custom Storefronts"
relatedModules:
  - name: settings-for-developers
    route: /admin/dashboard/settings/for-developers
path: manage-my-shop/apps-features-and-integrations/storefront-api-for-custom-storefronts
last_updated: '2026-04-27'
---

# Storefront API for Custom Storefronts

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 in your Fourthwall dashboard.

1. Go to **Settings > For Developers > Headless** at https://my-shop.fourthwall.com/admin/dashboard/settings/for-developers/?redirect
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: https://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.