NUMU Docs
Contact
API
ThemesPartner Apps
API
ThemesPartner Apps
  1. Online store
  • 🗂️ Overview
  • 🚀 Quickstart
  • Authentication
  • Webhooks
  • Errors
  • Pagination
  • Rate limits
  • API terms
  • Versioning
  • Changelog
  • Merchant APIs
    • Identity
      • Get current user
      • Identify the calling personal access token
    • Catalog
      • Create new product
      • List products
      • Get product by ID
      • Update product
      • Delete product
      • Upload product image
      • Delete product image
      • Set product image alt text
      • Download CSV import template
      • Import products from CSV
      • Export products as CSV
      • List variants for a product
      • Create a variant
      • Update a variant
      • Delete a variant
      • List gift cards
      • Issue a new gift card
      • Get gift card
      • List gift card transactions
      • Void a gift card (zero remaining balance)
      • Get inventory list
      • Get inventory statistics
      • Adjust stock level
      • Bulk adjust stock levels
      • List all inventory levels for a store
      • List inventory levels for a variant
      • List inventory levels at a location
      • Set inventory level at a location
      • List inventory transfers
      • Create a draft transfer
      • Get transfer
      • Replace lines (DRAFT only)
      • Move transfer through its state machine
      • Create new category
      • List categories
      • Get category by ID
      • Update category
      • Delete category
      • Upload category image
      • Create upsell rule
      • List upsell rules
      • Get upsell rule
      • Update upsell rule
      • Delete upsell rule
      • Create product bundle
      • List bundles for a store or product
      • Set bundles for a product (replace all)
      • Get bundle details
      • Update bundle
      • Delete bundle
      • Reorder bundles
    • Orders & fulfillment
      • List payment proofs for an order
      • List manual-payment orders awaiting merchant review
      • Create new order
      • List orders
      • Create a draft order
      • Convert draft order to a real order
      • List COD Autopilot exception orders
      • Resolve (dismiss) a COD Autopilot exception
      • Per-status order counts (list tab badges)
      • Update order
      • Cancel order
      • Update order status
      • Mark order as paid
      • Undo a manual mark-paid (payment back to pending)
      • Customer kept part of the order at the door
      • Get order timeline
      • List order activity stream (staff comments + system events)
      • Add a staff comment to an order
      • Bulk update order statuses
      • Resend order status email
      • Preview order status email
      • WhatsApp sends for an order
      • Resend the WhatsApp order confirmation
      • Abandoned vs recovered carts — counts, value, payback
      • List abandoned checkouts for a store
      • Get an abandoned checkout
      • Send a recovery email to the abandoned-checkout's customer
      • Manually mark an abandoned checkout as recovered
      • Turn an abandoned checkout into a real COD order
      • Send a WhatsApp abandoned-cart recovery nudge
      • Preview a CSV order import (parses headers + suggests mapping)
      • Execute a CSV order import with a confirmed mapping
      • List the target fields the importer understands
      • Send the order's payment link into a linked conversation
      • Request a refund for an order
      • List refunds for an order
      • Get refund details
      • Approve a refund request
      • Reject a refund request
      • Process a refund through payment provider
      • List all refunds for a store
      • List returns for the store
      • Get one return
      • Approve a pending return
      • Reject a return
      • Mark a return as physically received
      • Issue refund for a received return
      • Carrier catalog with this store's connection state
      • Save credentials for a carrier
      • Disconnect a carrier
      • Verify a carrier's stored credentials
      • Change a connected carrier's settings
      • Known Egyptian couriers to start from
      • This store's courier profiles
      • Add a courier
      • Update a courier
      • Remove a courier
      • Print waybills for a batch of shipments
      • Print one waybill
      • Export the pickup manifest as CSV
      • Preview a courier's status sheet
      • Apply reviewed status rows
      • Create shipment
      • List shipments
      • Bulk create shipments
      • Shipment dashboard stats
      • COD reconciliation summary
      • List pickups
      • Schedule a pickup
      • Get shipment detail
      • Update shipment on Bosta
      • Cancel shipment
      • Request return shipment
      • Track shipment
      • Print AWB (Air Waybill)
      • Get delivery details from Bosta
      • Get business pickup locations
      • Get pickup details
      • Update pickup
      • Cancel pickup
      • Get Bosta cities
      • Get zones in a city
      • Record an out-of-band payment against an order
      • Get order by ID or order number
    • Settings & money
      • Stream a payment proof image (merchant-authenticated)
      • Approve a customer-submitted proof
      • Reject a customer-submitted proof
      • Find perceptually similar prior proofs in this store
      • Create new invoice
      • List store invoices
      • Get invoice details
      • Update draft invoice
      • Delete draft invoice
      • Submit invoice to ETA
      • Download invoice PDF
      • Get (or create) the invoice for an order
      • List locations
      • Create location
      • Get location
      • Update location
      • Delete location
      • Get all store settings
      • Get payment settings
      • Update payment settings
      • Get COD trust network protection settings
      • Update COD trust network protection settings
      • Get COD Autopilot settings
      • Update COD Autopilot settings
      • Get storefront password-protection status
      • Enable/disable storefront password & set the password
      • Get the store's custom product-label definitions
      • Replace the store's custom product-label definitions
      • Save Paymob credentials
      • Get Paymob credentials status
      • Remove Paymob credentials
      • Save Kashier credentials
      • Get Kashier credentials status
      • Remove Kashier credentials
      • Save Fawaterak credentials
      • Get Fawaterak credentials status
      • Remove Fawaterak credentials
      • Save Moyasar credentials
      • Get Moyasar credentials status
      • Remove Moyasar credentials
      • Get shipping settings
      • Update shipping settings
      • Add shipping zone
      • Update shipping zone
      • Delete shipping zone
      • Save Bosta credentials
      • Get Bosta credentials status
      • Remove Bosta credentials
      • Get invoice/tax settings
      • Update invoice/tax settings
      • Get WhatsApp settings
      • Update WhatsApp settings
      • Get storefront customization settings
      • Update storefront customization (save draft)
      • Publish storefront customization to live store
      • Reset storefront customization to theme defaults
      • Upload a customization asset (logo, favicon, hero image)
      • List customization assets
      • Update an asset's alt text / display name
      • Delete a customization asset
      • Get checkout fields config
      • Update checkout fields config
      • Save InstaPay credentials
      • Get InstaPay credentials status
      • Remove InstaPay credentials
      • Save Vodafone Cash credentials
      • Get Vodafone Cash credentials status
      • Remove Vodafone Cash credentials
      • Save WE Pay credentials
      • Get WE Pay credentials status
      • Remove WE Pay credentials
      • Save Orange Cash credentials
      • Get Orange Cash credentials status
      • Remove Orange Cash credentials
      • Upload merchant-generated InstaPay QR image
      • Remove the uploaded InstaPay QR image
      • Get all tracking settings
      • Get the tracking-credential validation contract
      • Save Meta Pixel + CAPI settings
      • Disconnect Meta tracking
      • Send a synthetic Purchase test event to Meta
      • Get recent Meta CAPI events
      • Verify the Meta Pixel against Meta
      • Get Meta Event Match Quality
      • Get Meta tracking status
      • Save TikTok Pixel + Events API settings
      • Disconnect TikTok tracking
      • Send a synthetic Purchase test event to TikTok
      • Get recent TikTok Events API events
      • Get TikTok Events API deliveries that failed
      • Re-send failed TikTok Events API deliveries
      • Verify the TikTok Pixel against TikTok
      • Get TikTok tracking status
      • Get TikTok Marketing ad-performance report
      • Connect TikTok Shop (persist token + shop)
      • TikTok Shop connection status
      • Disconnect TikTok Shop
      • Get onboarding progress
      • Complete an onboarding step
      • Skip an onboarding step
      • Dismiss onboarding
      • Restore dismissed onboarding
      • Auto-configure store from wizard answers
      • List reconciliation runs
      • Get mismatches for a reconciliation run
      • Resolve or reopen a reconciliation mismatch
      • Trigger reconciliation for a date
      • Payment volume broken down by gateway
      • List shipping zones
      • Create a shipping zone
      • Get a shipping zone
      • Update a shipping zone
      • Deactivate (soft-delete) a shipping zone
      • Create a rate on a zone
      • Update a rate
      • Deactivate a rate
      • Return covered/uncovered governorates for the store
      • Apply the Quick Start: Egypt 4-zone preset
      • Preview rates for a cart (merchant calculator tool)
      • Get Balances
      • List Transactions
      • List Invoices
      • List installable apps
      • List installs for this store
      • Install an app
      • Update app settings
      • Disable app
      • Enable app
      • Uninstall app
      • Void a payment the merchant recorded by hand
      • Print the invoice for an order, paid or not
      • Signed link to a Partner App's own admin
      • The store's subscription to a paid app
      • Pay for a paid app from the store's wallet
      • Cancel a paid app at the end of the paid period
      • Re-send failed Meta Conversions API deliveries
    • Analytics
      • Get dashboard statistics
      • Get revenue chart data
      • Get top selling products (dashboard)
      • Get daily order streak
      • Get sales overview
      • Get sales chart data
      • Get top selling products (analytics)
      • Get sales by location
      • Get customer analytics
      • Get conversion statistics
      • Get orders by traffic source
      • Get COD rejection statistics
      • Get merchant health score
      • Get orders breakdown analytics
      • Get revenue breakdown analytics
      • Get customer RFM segmentation
      • Get inventory analytics (sell-through, ABC, dead stock)
      • Get product performance analytics
      • Get top storefront search terms
      • Customer health scores + states
      • Statistical predictions (stockouts, bands, repeat, COD)
      • Get active advisor signals
      • Dismiss an advisor signal
      • Re-run the advisor rules for this store now
      • Executive dashboard — what should I do today?
      • Anonymous peer benchmarks (k-anonymity gated)
      • Custom report: metrics grouped by a chosen dimension
      • Get weekly-digest preferences
      • Set weekly-digest preferences
      • Preview the weekly analytics digest
      • Get store-event annotations for charts
      • Get metric targets with live pace
      • Set metric targets
      • Get conversion funnel
      • Get marketing attribution analytics
      • Get customer LTV by first-touch acquisition channel
      • Get AI-powered store insights
      • Get sales forecast
      • Get customer sessions list
      • Get session detail timeline
      • Multi-touch attribution per channel + campaign
      • Get real-time analytics snapshot
      • Today's orders by location (governorate)
      • SSE stream for real-time analytics
    • Customers
      • Preview a CSV customer import (parses headers + suggests mapping)
      • Execute a CSV customer import with a confirmed mapping
      • List the target fields the customer importer understands
      • List store customers
      • Create a customer manually
      • Get customer by ID
      • Get customer COD trust network stats
      • Erase a customer's analytics footprint (DSAR)
      • Get a customer's full touchpoint journey
      • Conversations linked to this customer
      • Adopt a linked conversation's profile picture as the customer photo
    • Marketing
      • Create new coupon
      • List coupons
      • Get coupon by ID
      • Update coupon
      • Delete coupon
      • Bulk-update promotion priorities (drag-to-reorder)
      • Issue a short-lived preview token for the builder iframe
      • List promotions for a store
      • Create a new promotion
      • Get a single promotion by id
      • Update a promotion (optimistic lock via `version`)
      • Soft-delete (archive) a promotion
      • Duplicate a promotion as a new draft
      • Move a promotion to ACTIVE
      • Move a promotion to PAUSED
      • Move a promotion to ARCHIVED
      • Aggregate analytics for one promotion within a date range
      • List social connections
      • Connect social account
      • Disconnect social account
      • Fetch posts from connected account
      • Import social posts as draft products
      • Import products from Instagram/Facebook post URLs
      • Get Meta Embedded Signup config
      • Complete WhatsApp embedded signup
      • Disconnect WhatsApp Business
      • Get WhatsApp connection status
      • Get WhatsApp notification settings
      • Update WhatsApp notification settings
      • Get WhatsApp analytics
      • List recent WhatsApp messages
      • Connect merchant's own Meta WABA (BYO)
      • Disconnect BYO Meta WABA and revert to platform-managed
      • Get WhatsApp connection status (BYO-aware)
      • Update store-level WhatsApp preferences (e.g. message language)
      • Update notification toggles (BYO-path)
      • Get the store's WhatsApp access-gate state
      • Open (or resume) the bill for this store's WhatsApp access
      • Request WhatsApp access for this store (merchant)
      • List WhatsApp templates
      • Create WhatsApp template
      • Delete WhatsApp template
      • Sync template statuses from Meta
      • List registered email events
      • Get registry default template for an event/language
      • List merchant email templates
      • Create email template override
      • Get email template by ID
      • Update email template
      • Delete email template
      • Preview an unsaved email-template draft
      • Preview a saved email template
      • Send a test email rendered from this template
      • List conversations (inbox)
      • Get unread conversation count
      • Get messages for a conversation
      • Send a message in a conversation
      • Update conversation (mark read, archive, assign)
      • List campaigns
      • Create campaign draft
      • Get campaign details
      • Update campaign draft
      • Send campaign now
      • Schedule campaign
      • Cancel scheduled campaign
      • List campaign recipients
      • Estimate audience size
      • List Opt Ins
      • Create Opt In
      • Revoke Opt In
      • List Scheduled Sends
      • Create Scheduled Send
      • Get Scheduled Send
      • Cancel Scheduled Send
      • List Dead Letters
      • Get Dead Letter
      • Replay Dead Letter
      • Connect Meta
      • Meta Callback
      • Connect Assets
      • Sync History
      • Disconnect Channel
      • List Connections
      • List Threads
      • Get Thread
      • Mark Read
      • Resolve Thread
      • Link Customer
      • Unlink Customer
      • List Messages
      • Send Message
      • Create Template
      • List Templates
    • Online store
      • List menus
        GET
      • Create menu
        POST
      • Get menu by handle
        GET
      • Update (or create) a menu by handle
        PUT
      • Delete menu
        DELETE
      • List pages
        GET
      • Create page
        POST
      • Get page by handle
        GET
      • Update (or create) a page by handle
        PUT
      • Delete page
        DELETE
      • List all themes available to a store (built-in + external)
        GET
      • Submit External Theme
        POST
      • Get External Theme Info
        GET
      • Remove External Theme
        DELETE
      • Connect a local theme dev server (numu-theme dev)
        POST
      • Get Build Status
        GET
      • Rebuild External Theme
        POST
      • Validate External Theme
        POST
      • List all theme installations for a store
        GET
      • Install a theme on the store
        POST
      • Get a specific installation
        GET
      • Rename a theme installation
        PATCH
      • Uninstall a theme from the store
        DELETE
      • Duplicate a theme installation into a new draft copy
        POST
      • Export an installation as a portable JSON document
        GET
      • Activate an installed theme
        POST
      • Save draft customization (not yet live)
        PATCH
      • Publish draft customization (goes live)
        POST
      • Generate a preview URL for an installation
        POST
      • List the store's theme workspace files
        GET
      • Read one workspace file
        GET
      • Create or overwrite a workspace file
        PUT
      • Delete a workspace file
        DELETE
      • Seed a buildable starter theme into the workspace
        POST
      • Build & publish the code-editor workspace
        POST
      • Get Draft
        GET
      • Autosave Draft
        PUT
      • Publish
        POST
      • List Versions
        GET
      • Get Version Payload
        GET
      • Restore Version
        POST
      • Discard Draft
        POST
      • Get Schemas
        GET
      • Resolve Theme
        GET
      • List undo entries
        GET
      • Append an undo entry
        POST
      • Clear undo stack
        DELETE
      • Remove an undo entry (after applying)
        DELETE
    • OAuth
      • Token
      • Revoke
  1. Online store

Install a theme on the store

POST
https://numueg.app/api/v1/stores/{store_id}/themes/v2/install
Last modified:2026-09-19 16:39:33
x-numu-scope:themes:write
Install a marketplace theme on this store.
If version_id is omitted, the latest version is installed.
Returns 409 if the theme is already installed.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Successful Response
Bodyapplication/json

🟠422
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://numueg.app/api/v1/stores//themes/v2/install' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "theme_id": "uuid"
}'
Response Response Example
201 - Example 1
{
    "success": true,
    "data": {
        "activated_at": "2026-04-11T00:01:00Z",
        "created_at": "2026-04-11T00:00:00Z",
        "customization": {},
        "has_draft_changes": false,
        "id": "install-uuid",
        "installed_at": "2026-04-11T00:00:00Z",
        "is_active": true,
        "store_id": "store-uuid",
        "theme_id": "theme-uuid",
        "theme_name": "Modern",
        "theme_slug": "modern",
        "theme_type": "internal",
        "theme_version": "1.0.0",
        "updated_at": "2026-04-11T00:01:00Z"
    },
    "message": "string"
}
Modified at 2026-09-19 16:39:33
Previous
List all theme installations for a store
Next
Get a specific installation
Built with