Back to NexusFlow Home
Sign In

Custom Store Developer Hub

REST Push API v1Public Documentation

Integrate custom ecommerce platforms, headless frontends, ERPs, or internal catalogs directly into NexusFlow via standard REST endpoints with deterministic stock and price grounding.

Workspace ID:ws_sample_fashion_flagship
Public Developer Documentation & Sandbox.You can inspect endpoints, generate code snippets, and validate payload schemas without logging in.

Push Ingestion Endpoint

Send JSON product batches via standard HTTP POST

POSThttp://localhost:4000/api/v1/workspaces/ws_sample_fashion_flagship/integrations/custom/products
GET JSON/sample-catalog.json
Raw JSON
curl -X POST "http://localhost:4000/api/v1/workspaces/ws_sample_fashion_flagship/integrations/custom/products" \
  -H "Authorization: Bearer nxf_live_sample_token_8829..." \
  -H "Content-Type: application/json" \
  -d '{
    "products": [
      {
        "sourceId": "SKU-001",
        "title": "Wireless Studio Headphones",
        "priceCents": 14999,
        "currency": "USD",
        "inventoryCount": 50
      }
    ],
    "storeName": "My Custom Storefront"
  }'

Interactive Ingestion Sandbox

Validate payload structure or test ingest products directly into your workspace.

Presets:

Catalog Field Specification

Full parameter schema for REST ingestion batches

FieldTypeRequiredDefaultDescription
sourceIdstringYes—Unique identifier in your external ecommerce database (e.g. SKU or product UUID).
titlestringYes—Product title used deterministically for AI draft copy and marketing claims.
priceCentsintegerYes—Price in minor currency units (e.g. 2999 = $29.99). Enforces price accuracy.
currencystringNoUSD3-letter ISO-4217 currency code (e.g. USD, EUR, GBP, INR).
inventoryCountintegerNo0Stock quantity. Items with zero inventory trigger automated marketing pause alerts.
skustringNo—Merchant stock keeping unit for inventory matching.
descriptionstringNo—Product description and specs used to ground AI copy factuality.
urlstringNo—Storefront product URL used for automated UTM campaign link generation.
imagesstring[]No[]Array of image URLs attached to auto-generated social posts and carousels.
tagsstring[]No[]Taxonomy tags used for caption hashtag suggestions and campaign targeting.

Recent Ingestion Events

Audit history of catalog batch pushes into this workspace

Live Ingestion History Requires an Active Workspace

Sign in with your merchant account or launch the 1-Click Demo to push products to a database and track sync audit records.