Landing Pages

List landing pages (newest first) with per-page stats: views, attributed orders, revenue — orders count as placed regardless of status (cancelled/returned included). Filter by product or status. limit/offset are opt-in pagination; omitting them returns the full list.

Create a draft landing page for a product. The slug defaults to lp-<8 chars> and is editable later. The page charges the product's catalog price — there is no price override (the price story lives in the images).

Validation: the product must exist; a taken slug returns 409.

The A/B view: every landing page of one product side by side with views, orders, revenue — orders count as placed regardless of status (cancelled/returned included). Conversion rate = orders / views (undefined on zero views — compute client-side).

Full landing page detail: settings, the ordered image stack, the linked product, and stats.

Partial update — send only the fields you want to change (name, slug, spacing settings, SEO meta). A taken slug returns 409.

Permanently delete a landing page with NO attributed orders. Refused with LANDING_PAGE_HAS_ORDERS otherwise — archive instead so history stays intact. Images cascade.

Create a quick copy: a fresh DRAFT with a new slug, the same product, spacing, SEO meta, and image stack (images share the original immutable R2 objects — deleting an image elsewhere only removes the storage object when the last reference goes). Views, orders, revenue, and published state are never copied — a duplicate is a fresh creative test.

Make the page live at /lp/ and start counting views.

Return the page to draft — the link stops resolving (404) but history stays.

Retire the page while keeping its order history intact. The link stops resolving.

The image stack ordered by position (1 = top of the page).

Appends an uploaded image to the stack by its Media Key. Upload it first (POST /api/media/uploads with folder landing, send the file, complete the upload); its size comes from the upload.

Set the stack order. Send the complete ordered array of image IDs — every existing image ID exactly once.

Remove an image from the stack. The R2 object is deleted first — a storage failure aborts so no DB row points at a missing object.

This page's tracking: config is its own Meta Pixel + Conversions API configuration (null when it inherits the store's, which is the default for every page), and lastEvent is the most recent Conversions API attempt for an order this page produced — proof that a campaign is reporting, including Meta's own message when one failed. The access token is never returned, only a masked hint.

Give this page its own pixel, REPLACING the store's for its visitors and for the orders attributed to it — never adding to it. Takes effect only while the Meta App's per-page tracking switch is on (the Meta App's page).

accessToken is required when creating the override and optional afterwards: an empty value keeps the stored token, because the dashboard only ever holds a masked hint.

conversionEvent is required — which moment counts as a conversion is a spend decision and is never defaulted for the merchant.

testMode requires a testEventCode, or the events reach production measurement instead of Meta's test stream.

Return the page to the store pixel. Succeeds whether or not an override existed.