Aeolian Harp 001: Read our new article on where we think ecommerce is heading by 2030, and why it will be won with infrastructure
OverviewAPI Reference

Introduction

Learn how to integrate with the Aeolian CMS platform.

What is Aeolian CMS?

Aeolian CMS is a multi-tenant e-commerce and content management platform built for operators doing $100k/mo+. It gives you full control over your storefront, checkout, payments, and content — without the limitations of traditional SaaS platforms.

Why Aeolian?

Most e-commerce platforms force you into their ecosystem. Aeolian is different:

  • Multi-PSP payment orchestration — Route transactions across multiple payment processors to maximize approval rates and minimize fees
  • Server-side pixel tracking — First-party data collection that works without cookies, immune to ad blockers
  • Fully customizable checkout — Own every pixel of your checkout experience, no iframes or redirects
  • Zero false DMCA takedowns — Your content, your rules. No automated content removal systems
  • Multi-tenant architecture — Run multiple stores from a single account with complete data isolation

Core Concepts

Stores

A store is your top-level entity. Each store has its own domain, branding, products, customers, and orders. You can create multiple stores under a single Aeolian account.

Products & Variants

Products support unlimited variants (size, color, material, etc.), each with independent pricing, inventory tracking, and images. Variants can be organized into option groups for clean storefront presentation.

Collections

Collections let you group products for navigation and merchandising. A product can belong to multiple collections. Collections support manual ordering and automatic rules.

Customers

Customer profiles are created automatically when an order is placed, or can be created manually. Each customer has a full order history, saved addresses, and contact information.

Orders

Orders track the full lifecycle from placement through fulfillment. Each order records line items, shipping details, payment status, and fulfillment state. Orders support partial fulfillment and refunds.

Architecture

Aeolian is built on a modern stack designed for performance and reliability:

  • Next.js application server with server-side rendering
  • PostgreSQL database with Drizzle ORM
  • Redis for caching, rate limiting, and session management
  • S3-compatible object storage for media files
  • Resend for transactional email delivery

API-First Design

Every feature in Aeolian is accessible through the REST API. The admin dashboard is built entirely on the same API that's available to you, so there are no hidden capabilities or limitations.

Multi-Tenancy

Each store operates as an isolated tenant. Data is partitioned at the database level, ensuring complete separation between stores. API keys are scoped to individual stores with configurable permissions.

What's Next?

  • Follow the Quickstart guide to create your first store and make your first API call
  • Read the API section for detailed endpoint documentation
  • Check out the Webhooks guide to receive real-time event notifications