Store Endpoints

Create, update, and manage stores

Stores are the top-level entity for organizing products, orders, and checkout experiences. Each merchant can own up to 20 stores, and each store has its own webhook, notification, and checkout theme settings.

Store Status Values

Status	Description
active	Store is live and operational
inactive	Store is disabled by the merchant; data is preserved but checkout is unavailable
suspended	Store is suspended by the platform; merchant cannot reactivate

Role-Based Access Control

Each merchant in a store is assigned one of three roles. The store creator is automatically assigned owner.

Permission	owner	admin	member
Read store details	Yes	Yes	Yes
Update store settings	Yes	Yes	No
Delete store	Yes	No	No
Create store	—	—	—

Store creation is not role-gated — any authenticated merchant can create a new store (up to the 20-store limit). Roles only apply to operations on existing stores.

Endpoints

Create Store

Create a new store for the authenticated merchant.

Update Store

Update store name, status, or configuration settings.

Delete Store

Soft-delete a store (owner only).