NUMU Docs
Contact
APIThemes
APIThemes
    NUMU Developer Docs

    Build on NUMU

    A REST API for every part of a merchant's store, signed webhooks for everything that happens in it, and a React theme platform for the storefront itself.

    Start with the API → Build a theme OpenAPI JSON
    Your first call
    curl "https://numueg.app/api/v1/auth/api-key/me" \
      -H "Authorization: Bearer $NUMU_TOKEN"
    
    # 200 OK
    {
      "success": true,
      "data": {
        "store_id": "3fa85f64-…",
        "scopes": ["orders:read", "catalog:write"]
      }
    }

    Choose what you're building

    Connect a system to a merchant's store, or design the storefront their customers shop in.

    🔌

    API & webhooks

    Sync an ERP, push orders to fulfillment, build a dashboard or an internal tool.

    • Every part of the store: catalog, orders, customers, marketing
    • One token per store, scoped to what it needs
    • Signed, retried webhooks for orders and products
    • Snippets in cURL, JavaScript, Python and PHP
    Read the API docs →
    🎨

    Themes

    Design the storefront shoppers see — every page, section and block, in React.

    • The numu-theme CLI: scaffold, preview, build, publish
    • A theme SDK for products, cart, checkout and accounts
    • Arabic and right-to-left from the first line
    • Listed in the NUMU theme marketplace after review
    Read the theme docs →

    What you can build with the API

    Every group has its own scopes, so a token only reaches what your integration needs.

    📦
    CatalogProducts, inventory, categories and bundles
    🧾
    Orders & fulfillmentOrders, shipments, returns and refunds
    👥
    CustomersCustomer records
    📣
    MarketingWhatsApp, promotions, coupons and email
    📈
    AnalyticsSales and store analytics
    ⚙️
    Settings & moneySettings, shipping rates, invoices and payments
    🛍️
    Online storeThemes, pages and menus
    🔔
    WebhooksHear about orders and products as they change

    Make your first call

    Three steps from nothing to a working request.

    Get API access

    Included in the Pro plan. On any other plan, ask us and we switch it on for your store.

    Create a key

    In your dashboard: Settings → API & webhooks → Create key. Pick only the scopes you need.

    Call the API

    Send it as Authorization: Bearer … to https://numueg.app/api/v1. Quickstart →

    Resources

    📰 Changelog 🧭 Versioning ⏱️ Rate limits ⚠️ Errors 📜 API terms 📖 Glossary ✉️ Talk to our engineers
    © NUMU numueg.app · Merchant dashboard · support@numueg.app