Salla Developers

Salla Developers

What are you building on Salla?

Salla is the commerce platform for tens of thousands of merchants across Saudi Arabia and the GCC. Build apps, storefront themes and integrations — Salla runs billing, tax and payouts. Pick a goal below; each path routes you to the exact APIs, tools and guides you need.

Know the drill? Scaffold an app now
npm create @salla.sa/app

or just describe it to your AI editor — see the Partners MCP

Core concepts

Eight words do most of the work on this platform. Learn them once.

Store & MerchantA Salla store and its owner. Your app acts on the merchant's behalf, per store.
AppYour integration, registered in the Partners portal. Public (listed in the App Store) or private.
ScopeA permission the merchant grants at install: orders.read, products.write, and so on.
Access tokenWhat the OAuth flow returns. Sent on every Merchant API request for that store.
WebhookAn HTTP callback Salla sends your server when something changes in the store.
App FunctionYour code, run by Salla when a store event fires. No server to host.
SnippetA fragment of UI you inject into defined storefront or dashboard slots.
ThemeA Twilight storefront design. Separate lifecycle — ships to the Themes store.

What you can ship

Every one of these lists in a Salla store. Use it to pick your path.

TypeBuilt onLists in
Public appsMerchant & Partner APIsApp Store
Private appsMerchant API + webhooks, OAuthUnlisted — installed by link
Embedded appsEmbedded SDKApp Store — render inside the dashboard
Storefront themesTwilightThemes store
Custom reportsReport BuilderMerchant dashboard
Shipping & fulfilment appsShipment API + Salla AWBApp Store
Payment & subscription appsRecurring Payments APIApp Store
Communication appsCommunication Apps APIApp Store

Pick a path

Build an app publish to the Salla App Store
I'd rather describe it to my AI editorThe Partners MCP registers and configures the app for you I'm starting from zeroCreate a Partners account, register an app, get OAuth keys and set a callback I need store dataRead and write orders, products, customers and inventory with the Merchant API I want UI inside the dashboardRender app screens natively in the merchant dashboard with the Embedded SDK I want to inject storefront UIDrop content into storefront and dashboard slots with App Snippets I want serverless logic on store eventsRun code on ecommerce events with App Functions — no server to host I'm ready to launchApp branding and listing, then submit for review and publish
Build a storefront theme publish to the Themes store
I'm new to themesScaffold a Twilight theme with the CLI and run it against a demo store I want to understand theme structureTwig templating, twilight.json and the Twilight Engine I need cart, checkout and customer state in JSThe Twilight SDK helpers for storefront behaviour I want ready-made UI elementsFramework-free Twilight Web Components you can drop in and style I want the full component packageThe versioned Component Bundle for production themes
Connect to Salla integrate an external system

Pulling Salla data into your own ERP, POS, CRM or site. You still register an app for OAuth, but you don't have to list it publicly.

First, get authenticatedRegister a private app, request scopes and complete the OAuth flow Products & inventoryList, create and update products, options, categories and stock Orders & fulfilmentRead orders, update status, and drive shipping and fulfilment CustomersCustomer records, groups and addresses via the Merchant API Shipments & labelsRegister as a carrier, create shipments and print AWBs Stay in syncSubscribe to webhooks so your system hears about every change
Automate something react to store and app activity
A customer does somethingCart, checkout, order and profile activity via Ecommerce Events Something happens to my appInstall, uninstall, subscription and settings changes via App Events Notify my server60+ events, conditional delivery and signed payloads Run my own logic, no serverApp Functions execute your code on store events Drive it from an AI editorThe Partners MCP builds and wires apps from Claude Code, Cursor or Codex

Quickstart

The five-minute version for building an app. Everything here also works from the Partners MCP.

Before you start
  • Node.js 18 or newer
  • A Salla Partners account — free to create
  • A demo store to develop against, created from the portal

  1. Install the CLI

    npm i -g @salla.sa/cli

  2. Scaffold an app or a theme

    salla app create my-app

  3. Develop with live webhook tunneling, pointed at your demo store

    salla app serve

  4. Publish for review

    salla app publish

The app lifecycle

Every app moves through the same seven stages — by hand, by CLI, or through the MCP. Pick a stage to see what it takes.

Partners MCP

Build apps from your AI editor

The Partners Agent Kit gives your AI editor two things: Skills — how Salla apps are built — and the Partners MCP, a live connection to the Partners portal. Describe an app task in plain language; the MCP carries it out on your account, showing you each change and waiting for your yes.

npx @salla.sa/agent-kit install

MCP server

What it does on the portal
  • Register an app — public or private
  • Set OAuth scopes & callback URL
  • Subscribe to webhooks & ecommerce events
  • Edit app settings & store listing
  • Read install status & connected stores
  • Run the review checklist & publish
Things you can just say

Create a private app called Inventory Sync with the products and orders read scopes.

Subscribe it to order.created and order.status.updated, callback https://sync.acme.dev/webhooks.

Add products.write, then show me the OAuth install URL.

Run the review checklist and submit the app.

Works in Claude Code, Cursor, Codex and Copilot. Every write action is shown before it runs.

Read the Agent Kit guide

For experienced developers

The whole platform surface, in one list. Search it.

Core

Merchant APIOrders, products, customers, inventory, coupons, branches Webhooks60+ events, conditional delivery, signed payloads App Functions & Ecommerce EventsRun code on store events, no server API reference & PostmanEndpoint reference, OpenAPI spec, collection

Storefront — Twilight

Twilight EngineTwig templating, theme structure Twilight SDKCart, checkout, customer state in JS Twilight ComponentsFramework-free Web Components Component BundleThe full component package, versioned

Partner APIs

Apps APIManage your app, its stores and scopes Shipment & FulfilmentRegister as a carrier, drive fulfilment Salla AWBAir waybills and shipping labels Recurring Payments APISubscriptions and scheduled billing Communication AppsSMS, WhatsApp, notification channels

Partners platform

App brandingLogo, listing, screenshots, localized presence App snippetsInject UI into storefront and dashboard slots Billing & payoutsPlans, trials, invoicing, tax, revenue share Publication & reviewSubmit, pass review, go live App OnboardingGuided setup shown on install

Tools

Salla CLIScaffold, tunnel, publish Embedded SDKDashboard-native UI Partners Agent Kit & MCPBuild apps from your AI editor Report BuilderCustom merchant reports

Concept markers — ° points at the docs root, needs a real deep link  ·  ° deep link or fact borrowed from elsewhere, needs verifying. Strip before ship.

Full documentation on docs.salla.dev

Get help

Developer communityt.me/salladev — fastest answers Office hoursLive sessions with the platform team Examples & issuesSample apps and bug reports on GitHub Platform statusLive API and dashboard health ChangelogWhat shipped, and what's breaking Blog & tutorialsDeep dives and walkthroughs