Salla Developers

Salla Developers

What are you building on Salla?

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

See exactly how, step by step

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

Build & test on a demo store. Stage 4 of 7.

Every app follows the same seven stages, from an empty repo to live. See the full path

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, with its own 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 or invitation
Embedded appsEmbedded SDKApp Store, rendered 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

The app lifecycle

Seven stages, from an empty repo to live. Each one shows how to do it by hand, CLI for local dev steps or Portal for account and review steps, or by describing it to the Partners MCP. Playing on its own every 4s. Click any stage to jump in.

Stage 1 of 7

Register an app

Create the app in the Partners portal, or have the MCP create it, then scaffold a local project. Public apps list in the App Store; private apps install by link.

CLI salla app create
MCP “Create a private app called Inventory Sync”

Create an app

Commands and prompts are illustrative. Check the docs for exact syntax.

Partners MCP

Build apps from your AI editor

The Partners Agent Kit gives your AI editor two things: Skills, which teach it 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.

claude plugin marketplace add SallaApp/salla-partners-agent-kit

MCP server

What it does on the portal
  • Register an app, public or private
  • Set OAuth scopes
  • Subscribe to store events
  • Add snippets & dashboard pages
  • Run the review checklist & publish
Things you can just say

Build a shipping app for my carrier.

Add a monthly subscription plan with a 7-day trial.

Send a WhatsApp message when an order is placed.

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

Read the Agent Kit guide

Full platform reference

Every API, tool and guide, in one searchable list.

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, print AWBs Recurring Payments APISubscriptions and scheduled billing Communication AppsSMS, WhatsApp, notification channels via App Functions

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 ChangelogPlatform updates that can affect your app Platform statusCheck before you file an incident

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

Full documentation on docs.salla.dev

Get help

Stuck, or just curious what's new? Here's where to go.

Community GitHub examples Status Changelog Blog & tutorials