Salla website screenshot

Salla

Salla is a Saudi Arabia-based e-commerce platform — often called the Shopify of the Middle East — that lets merchants launch, operate, and grow Arabic-first online stores without code. Founded in 2016 in Makkah by Nawaf Hariri and Salman Butt, Salla now powers more than 80,000 active stores. The platform exposes a Merchant REST API (https://api.salla.dev/admin/v2), an OAuth 2.0 Partners authorization service, signed webhooks for the full storefront lifecycle, a Shipping and Fulfillment app contract, the Twilight theme engine and JavaScript SDK, the Salla CLI, and official starter kits for PHP/Laravel and Node.js/Express. Backed by Sanabil (PIF), STV, Investcorp, Vision Ventures, and Raed Ventures, Salla raised a $130M pre-IPO round in 2024.

Salla publishes 17 APIs on the APIs.io network, including Webhooks, Branches API, Brands API, and 14 more. Tagged areas include Arabic, E-Commerce, GCC, Headless Commerce, and Merchant.

The Salla catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Salla’s developer surface includes authentication, developer portal, documentation, getting-started guide, signup flow, developer console, pricing, and 45 more developer resources.

68.2/100 exemplar ▼ -6.9 Agent 36/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serveFree trial⚡ Free to try
18 APIs 10 Features 7 Use Cases
ArabicE-CommerceGCCHeadless CommerceMerchantMENAOnline StoresRetailSaudi ArabiaSMBStorefront

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 68.2/100 · exemplar
Contract Quality 17.1 / 25
Developer Ergonomics 15.7 / 20
Commercial Clarity 14.2 / 20
Operational Transparency 8.9 / 13
Governance 8.3 / 12
Discoverability 6.5 / 10
Agent readiness — 36/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/salla: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 18

Individual APIs this provider publishes, each with its own machine-readable definition.

Salla Webhooks

Server-to-server event delivery covering order, product, customer, shipping, shipment, store branch, category, brand, abandoned cart, coupon, invoice, special offer, and review ...

Salla Twilight SDK

JavaScript SDK and Twig-based theme engine for the storefront. Provides helper methods and REST proxies that let merchant themes and embedded components communicate with the Sal...

Salla Branches API

The Branches API from Salla — 2 operation(s) for branches.

Salla Brands API

The Brands API from Salla — 2 operation(s) for brands.

Salla Carts API

The Carts API from Salla — 1 operation(s) for carts.

Salla Categories API

The Categories API from Salla — 2 operation(s) for categories.

Salla Coupons API

The Coupons API from Salla — 1 operation(s) for coupons.

Salla Customers API

The Customers API from Salla — 2 operation(s) for customers.

Salla Financial API

The Financial API from Salla — 2 operation(s) for financial.

Salla Localization API

The Localization API from Salla — 4 operation(s) for localization.

Salla OAuth API

The OAuth API from Salla — 3 operation(s) for oauth.

Salla Orders API

The Orders API from Salla — 6 operation(s) for orders.

Salla Products API

The Products API from Salla — 5 operation(s) for products.

Salla Shipments API

The Shipments API from Salla — 4 operation(s) for shipments.

Salla Shipping API

The Shipping API from Salla — 6 operation(s) for shipping.

Salla Store API

The Store API from Salla — 1 operation(s) for store.

Salla Webhooks API

The Webhooks API from Salla — 3 operation(s) for webhooks.

Salla Zones API

The Zones API from Salla — 2 operation(s) for zones.

Scroll for all 18

Postman Collections 2

Ready-to-run Postman collections for exercising this provider's APIs.

Open Collections 4

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Salla Apps API

OPEN COLLECTION

Salla Merchant API

OPEN COLLECTION

Salla Webhooks

OPEN COLLECTION

Arazzo Workflows 11

Multi-step API workflows described with the Arazzo specification.

Salla Abandoned Cart Recovery

Find abandoned carts, look up the shopper, and issue a recovery coupon.

ARAZZO

Salla Catalog Taxonomy Setup

Create a brand and category, then create a product assigned to both.

ARAZZO

Salla Upsert Customer

Find a customer in a page of results and update them, otherwise create a new customer.

ARAZZO

Salla OAuth Token Exchange

Exchange an authorization code for an access token and confirm the merchant identity.

ARAZZO

Salla Order Fulfillment

Read an order, create its shipment, and advance the order status.

ARAZZO

Salla Monitor and Audit Orders

List orders by status, then pull the full detail, history, and invoices for one.

ARAZZO

Salla Create and Verify Product

Create a product, read it back, and confirm its generated SKUs.

ARAZZO

Salla Upsert Product by SKU

Find a product by keyword and update it if it exists, otherwise create it.

ARAZZO

Salla Shipment Lifecycle

Resolve a courier, create a shipment, read it back, and branch on whether to cancel.

ARAZZO

Salla Shipping Zone Setup

Register a shipping company, create a delivery zone for it, and read the zone back.

ARAZZO

Salla Webhook Subscription Setup

Inspect existing webhook subscriptions, subscribe to an event, and confirm registration.

ARAZZO

Scroll for all 11

Pricing Plans 1

Published pricing tiers and plan structures.

Salla Plans Pricing

5 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Salla Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Salla Finops

FINOPS

Features 10

Notable capabilities this provider offers.

Arabic-First No-Code Store Builder

Storefront builder with Arabic-first UX, RTL support, and localized payment, shipping, and tax integrations built for the GCC market.

Salla Merchant API

REST API at https://api.salla.dev/admin/v2 covering products, orders, customers, branches, brands, categories, currencies, languages, coupons, taxes, abandoned carts, shipping, ...

OAuth 2.0 Partners Authorization

OAuth 2.0 authorization with 14-day access tokens and 1-month refresh window; scoped per app via the Partners Portal.

Webhooks with Conditional Rules

HMAC SHA-256 signed webhooks (X-Salla-Signature / X-Salla-Security-Strategy headers) for order, product, customer, shipping, shipment, store, category, brand, abandoned-cart, co...

Twilight Theme Engine and SDK

JavaScript SDK plus Twig-based theme engine with pre-built web components (cart, checkout, login, search, product display) for storefront customization.

Salla CLI

Command-line tool for scaffolding, developing, and publishing Salla apps and themes to the Partners Portal.

Shipping App Contract

A Shipping and Fulfillment API contract that lets logistics providers plug directly into the Salla shipment flow.

ZATCA E-Invoicing

First-class support for Saudi Arabia's ZATCA (Fatoora) e-invoicing QR code requirement via the official open-source PHP package.

Embedded SDK and Apps Marketplace

Embedded SDK lets partner apps render inside the merchant dashboard; the Salla App Store distributes third-party apps to 80,000+ stores.

Saudi Payments and Logistics

Native integrations with STC Pay, mada, Apple Pay, Tabby, Tamara, HyperPay, Mada Pay, Aramex, SMSA, DHL, J&T, and other regional payment and logistics providers.

Scroll for all 10

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Salla Context

0 classes · 5 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Salla API Rules

5 rules · 4 warnings 1 info

SPECTRAL

Salla API Rules

9 rules · 3 errors 3 warnings 3 info

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

Salla Customer

14 properties

JSON SCHEMA

Salla Order

16 properties

JSON SCHEMA

Salla Product

21 properties

JSON SCHEMA

Examples 2

Example request and response payloads for these APIs.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Salla Authentication

http/oauth2 · 2 schemes

SECURITY

Salla Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Salla Scopes

11 scopes · authorizationCode

11 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Salla Agentic Access

69 operations · 30 acting

69 operations · 30 acting

AGENTIC

Use Cases 7

What developers build with this provider.

Custom Merchant Apps

Build custom apps published in the Salla App Store that extend merchant capabilities — inventory sync, order routing, marketing automation, ERP integration.

ERP and Accounting Integrations

Sync orders, products, customers, and invoices to SAP, Oracle NetSuite, Odoo, Zoho Books, QuickBooks, or custom accounting systems.

Custom Storefronts and Themes

Build custom Twilight themes or headless storefronts that render Salla catalog and checkout through a fully custom front end.

Shipping Provider Onboarding

Logistics companies expose their pickup, label printing, tracking, and return surface as a Salla Shipping App to serve every merchant on the platform.

Marketing and CRM Automation

Subscribe to customer, order, and abandoned-cart webhooks to drive CRM, email, SMS, and WhatsApp campaigns through Mailchimp, Klaviyo, or in-house automation.

AI Shopping Assistants

Use the Merchant API plus Naftiko capabilities to power AI agents that browse catalog, place orders, track shipments, and respond to merchant questions.

ZATCA Compliance

Generate the Saudi ZATCA Phase-1 / Phase-2 e-invoicing QR code on every receipt to remain compliant with Saudi Arabian tax authority requirements.

Scroll for all 7

Integrations 9

Pre-built integrations with other platforms and tools.

STC Bank

Native STC Bank digital wallet payment option across all Salla-powered stores.

Tabby and Tamara

Buy-now-pay-later integrations widely used in the GCC market.

Apple Pay and mada

Apple Pay and the Saudi mada national payment network.

HyperPay and Moyasar

Regional payment gateways supporting cards, wallets, and bank transfers.

Aramex, SMSA, J&T, DHL

Pre-built shipping integrations for Saudi Arabia and GCC delivery.

ZATCA

Saudi Arabian Zakat, Tax and Customs Authority e-invoicing.

WhatsApp Business

Customer notifications and conversational commerce.

Mailchimp and Klaviyo

Email and customer marketing automation.

Snapchat and TikTok Pixels

Storefront pixels and conversion tracking for GCC-focused ad platforms.

Scroll for all 9

Solutions 4

Packaged solutions this provider offers.

Sellers

Merchants of any size launching an online store with Arabic-first UX, regional payments, and built-in logistics.

Partners

Developers and agencies building apps, themes, and integrations distributed through the Salla Partners Portal and App Store.

Shipping Companies

Logistics providers offering their service to 80,000+ merchants by implementing the Salla Shipping App contract.

Enterprise

Larger brands needing custom themes, dedicated infrastructure, and bespoke commercial terms.

Resources

Get Started 4

Portal, sign-up, and the first successful call

Documentation 4

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 13

Pagination, idempotency, versioning, errors, and events

Scroll for all 13

Build 13

SDKs, sample code, and the tooling you integrate with

Scroll for all 13

Access & Security 3

Authentication, authorization, and security posture

Learn 1

Tutorials, courses, talks, and written guidance

Operate 5

Status, limits, changes, and where to get help

Commercial 5

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: salla
url: https://raw.githubusercontent.com/api-evangelist/salla/refs/heads/main/apis.yml
apis:
- aid: salla:salla-webhooks
  name: Salla Webhooks
  tags:
  - E-Commerce
  - Events
  - Webhooks
  humanURL: https://docs.salla.dev/421119m0
  properties:
  - url: https://docs.salla.dev/421119m0
    type: Documentation
  - url: https://docs.salla.dev/433804m0
    name: Orders Webhook Events Model
    type: Documentation
  - url: openapi/salla-webhooks-asyncapi.yml
    type: AsyncAPI
  description: Server-to-server event delivery covering order, product, customer, shipping, shipment, store branch, category,
    brand, abandoned cart, coupon, invoice, special offer, and review lifecycle events. Payloads are signed via HMAC SHA-256
    — X-Salla-Security-Strategy and X-Salla-Signature headers (or token strategy with Authorization header) — and developers
    can attach conditional rules per subscription.
- aid: salla:twilight-sdk-api
  name: Salla Twilight SDK
  tags:
  - E-Commerce
  - Storefront
  - SDK
  - Themes
  humanURL: https://docs.salla.dev/twilight
  properties:
  - url: https://docs.salla.dev/twilight
    type: Documentation
  - type: SDKs
    url: https://github.com/SallaApp/theme-raed
  description: JavaScript SDK and Twig-based theme engine for the storefront. Provides helper methods and REST proxies that
    let merchant themes and embedded components communicate with the Salla backend, plus a library of pre-built web components
    (login, search, product display, cart, checkout).
- aid: salla:salla-branches-api
  name: Salla Branches API
  description: The Branches API from Salla — 2 operation(s) for branches.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Branches
  properties:
  - type: OpenAPI
    url: openapi/salla-branches-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-brands-api
  name: Salla Brands API
  description: The Brands API from Salla — 2 operation(s) for brands.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Brands
  properties:
  - type: OpenAPI
    url: openapi/salla-brands-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-carts-api
  name: Salla Carts API
  description: The Carts API from Salla — 1 operation(s) for carts.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Carts
  properties:
  - type: OpenAPI
    url: openapi/salla-carts-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-categories-api
  name: Salla Categories API
  description: The Categories API from Salla — 2 operation(s) for categories.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Categories
  properties:
  - type: OpenAPI
    url: openapi/salla-categories-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-coupons-api
  name: Salla Coupons API
  description: The Coupons API from Salla — 1 operation(s) for coupons.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Coupons
  properties:
  - type: OpenAPI
    url: openapi/salla-coupons-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-customers-api
  name: Salla Customers API
  description: The Customers API from Salla — 2 operation(s) for customers.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Customers
  properties:
  - type: OpenAPI
    url: openapi/salla-customers-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-financial-api
  name: Salla Financial API
  description: The Financial API from Salla — 2 operation(s) for financial.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Financial
  properties:
  - type: OpenAPI
    url: openapi/salla-financial-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-localization-api
  name: Salla Localization API
  description: The Localization API from Salla — 4 operation(s) for localization.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Localization
  properties:
  - type: OpenAPI
    url: openapi/salla-localization-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-oauth-api
  name: Salla OAuth API
  description: The OAuth API from Salla — 3 operation(s) for oauth.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - OAuth
  properties:
  - type: OpenAPI
    url: openapi/salla-oauth-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-orders-api
  name: Salla Orders API
  description: The Orders API from Salla — 6 operation(s) for orders.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/salla-orders-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-products-api
  name: Salla Products API
  description: The Products API from Salla — 5 operation(s) for products.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Products
  properties:
  - type: OpenAPI
    url: openapi/salla-products-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-shipments-api
  name: Salla Shipments API
  description: The Shipments API from Salla — 4 operation(s) for shipments.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Shipments
  properties:
  - type: OpenAPI
    url: openapi/salla-shipments-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-shipping-api
  name: Salla Shipping API
  description: The Shipping API from Salla — 6 operation(s) for shipping.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Shipping
  properties:
  - type: OpenAPI
    url: openapi/salla-shipping-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-store-api
  name: Salla Store API
  description: The Store API from Salla — 1 operation(s) for store.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Store
  properties:
  - type: OpenAPI
    url: openapi/salla-store-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-webhooks-api
  name: Salla Webhooks API
  description: The Webhooks API from Salla — 3 operation(s) for webhooks.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Webhooks
  properties:
  - type: OpenAPI
    url: openapi/salla-webhooks-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
- aid: salla:salla-zones-api
  name: Salla Zones API
  description: The Zones API from Salla — 2 operation(s) for zones.
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  tags:
  - Zones
  properties:
  - type: OpenAPI
    url: openapi/salla-zones-api-openapi.yml
  - type: Documentation
    url: https://docs.salla.dev/421117m0
  - type: Documentation
    url: https://docs.salla.dev/5394168e0
  - type: Documentation
    url: https://docs.salla.dev/5394147e0
  - type: JSONSchema
    url: json-schema/salla-product-schema.json
  - type: JSONSchema
    url: json-schema/salla-order-schema.json
  - type: JSONSchema
    url: json-schema/salla-customer-schema.json
  - type: JSONLD
    url: json-ld/salla-context.jsonld
  - type: Examples
    url: examples/salla-list-products-example.json
  - type: Examples
    url: examples/salla-create-order-example.json
  - type: Documentation
    url: https://docs.salla.dev/421118m0
  - type: Documentation
    url: https://docs.salla.dev/5394234e0
  - type: Documentation
    url: https://docs.salla.dev/5394248e0
name: Salla
tags:
- Arabic
- E-Commerce
- GCC
- Headless Commerce
- Merchant
- MENA
- Online Stores
- Retail
- Saudi Arabia
- SMB
- Storefront
kind: contract
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: true
  try_now: true
  public: false
  label: Freemium (free trial) · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/salla.png
access: 3rd-Party
common:
- type: AgenticAccess
  url: agentic-access/salla-agentic-access.yml
- type: DomainSecurity
  url: security/salla-domain-security.yml
- type: Authentication
  url: authentication/salla-authentication.yml
- type: OAuthScopes
  url: scopes/salla-scopes.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/salla/overview
- type: Arazzo
  url: arazzo/salla-abandoned-cart-recovery-workflow.yml
  name: Salla Abandoned Cart Recovery
- type: Arazzo
  url: arazzo/salla-catalog-taxonomy-setup-workflow.yml
  name: Salla Catalog Taxonomy Setup
- type: Arazzo
  url: arazzo/salla-customer-upsert-workflow.yml
  name: Salla Upsert Customer
- type: Arazzo
  url: arazzo/salla-oauth-token-exchange-workflow.yml
  name: Salla OAuth Token Exchange
- type: Arazzo
  url: arazzo/salla-order-fulfillment-workflow.yml
  name: Salla Order Fulfillment
- type: Arazzo
  url: arazzo/salla-order-monitor-workflow.yml
  name: Salla Monitor and Audit Orders
- type: Arazzo
  url: arazzo/salla-product-create-verify-workflow.yml
  name: Salla Create and Verify Product
- type: Arazzo
  url: arazzo/salla-product-upsert-workflow.yml
  name: Salla Upsert Product by SKU
- type: Arazzo
  url: arazzo/salla-shipment-lifecycle-workflow.yml
  name: Salla Shipment Lifecycle
- type: Arazzo
  url: arazzo/salla-shipping-zone-setup-workflow.yml
  name: Salla Shipping Zone Setup
- type: Arazzo
  url: arazzo/salla-webhook-subscription-workflow.yml
  name: Salla Webhook Subscription Setup
- url: https://salla.com
  type: Portal
- url: https://salla.dev
  name: Salla Developers
  type: Documentation
- url: https://docs.salla.dev/
  name: Salla Partners Documentation
  type: Documentation
- url: https://docs.salla.dev/421117m0
  type: GettingStarted
- url: https://salla.partners/login
  name: Salla Partners Portal
  type: Signup
- url: https://salla.partners
  name: Salla Partners
  type: Console
- url: https://salla.com/pricing
  type: Pricing
- url: https://salla.com/terms
  type: TermsOfService
- url: https://salla.com/privacy
  type: PrivacyPolicy
- url: https://salla.com/blog
  type: Blog
- url: https://status.salla.sa/
  type: StatusPage
- url: mailto:support@salla.dev
  type: Support
- url: https://docs.salla.dev/421127m0
  name: Merchant API Changelog
  type: ChangeLog
- url: https://github.com/SallaApp
  type: GitHubOrganization
- url: https://www.postman.com/salla-app/salla-e-commerce-platform/overview
  name: Salla Postman Workspace
  type: Documentation
- url: https://www.postman.com/salla-app/salla-e-commerce-platform/collection/a2rh372/merchant-apis-v2-6-7
  name: Merchant APIs v2.6.7 Postman Collection
  type: Documentation
- url: https://www.youtube.com/@sallaapp
  type: YouTube
- url: https://twitter.com/sallaApp
  type: Twitter
- url: https://www.linkedin.com/company/salla-app
  type: LinkedIn
- url: https://github.com/SallaApp/Salla-CLI
  name: Salla CLI
  type: CLI
- url: https://github.com/SallaApp/laravel-starter-kit
  name: Laravel Starter Kit
  type: SDKs
- url: https://github.com/SallaApp/express-starter-kit
  name: Express.js Starter Kit
  type: SDKs
- url: https://github.com/SallaApp/oauth2-merchant
  name: OAuth2 Merchant Client (PHP)
  type: SDKs
- url: https://github.com/SallaApp/passport-strategy
  name: Passport OAuth Strategy (Node.js)
  type: SDKs
- url: https://github.com/SallaApp/webhook-actions-js
  name: Webhook Actions (Node.js)
  type: SDKs
- url: https://github.com/SallaApp/ZATCA
  name: ZATCA (Fatoora) E-Invoicing QR Code (PHP)
  type: SDKs
- url: https://github.com/SallaApp/theme-raed
  name: Twilight Theme Raed
  type: Tools
- url: https://github.com/SallaApp/twilight-vscode-extension
  name: Twilight VSCode Extension
  type: Tools
- url: https://github.com/SallaApp/embedded-sdk-playground
  name: Embedded SDK Playground
  type: Tools
- url: https://github.com/SallaApp/store-events-tracker-starter-kit
  name: Store Events Tracker Starter Kit
  type: Tools
- url: https://t.me/sallaDevelopers
  name: Salla Developers Telegram
  type: Forums
- url: rules/salla-rules.yml
  type: SpectralRules
- url: vocabulary/salla-vocabulary.yml
  type: Vocabulary
- url: plans/salla-plans-pricing.yml
  type: Plans
- url: rate-limits/salla-rate-limits.yml
  type: RateLimits
- url: finops/salla-finops.yml
  type: FinOps
- type: Features
  data:
  - name: Arabic-First No-Code Store Builder
    description: Storefront builder with Arabic-first UX, RTL support, and localized payment, shipping, and tax integrations
      built for the GCC market.
  - name: Salla Merchant API
    description: REST API at https://api.salla.dev/admin/v2 covering products, orders, customers, branches, brands, categories,
      currencies, languages, coupons, taxes, abandoned carts, shipping, and store settings.
  - name: OAuth 2.0 Partners Authorization
    description: OAuth 2.0 authorization with 14-day access tokens and 1-month refresh window; scoped per app via the Partners
      Portal.
  - name: Webhooks with Conditional Rules
    description: HMAC SHA-256 signed webhooks (X-Salla-Signature / X-Salla-Security-Strategy headers) for order, product,
      customer, shipping, shipment, store, category, brand, abandoned-cart, coupon, invoice, special offer, and review events
      — with per-subscription conditional rules.
  - name: Twilight Theme Engine and SDK
    description: JavaScript SDK plus Twig-based theme engine with pre-built web components (cart, checkout, login, search,
      product display) for storefront customization.
  - name: Salla CLI
    description: Command-line tool for scaffolding, developing, and publishing Salla apps and themes to the Partners Portal.
  - name: Shipping App Contract
    description: A Shipping and Fulfillment API contract that lets logistics providers plug directly into the Salla shipment
      flow.
  - name: ZATCA E-Invoicing
    description: First-class support for Saudi Arabia's ZATCA (Fatoora) e-invoicing QR code requirement via the official open-source
      PHP package.
  - name: Embedded SDK and Apps Marketplace
    description: Embedded SDK lets partner apps render inside the merchant dashboard; the Salla App Store distributes third-party
      apps to 80,000+ stores.
  - name: Saudi Payments and Logistics
    description: Native integrations with STC Pay, mada, Apple Pay, Tabby, Tamara, HyperPay, Mada Pay, Aramex, SMSA, DHL,
      J&T, and other regional payment and logistics providers.
- type: UseCases
  data:
  - name: Custom Merchant Apps
    description: Build custom apps published in the Salla App Store that extend merchant capabilities — inventory sync, order
      routing, marketing automation, ERP integration.
  - name: ERP and Accounting Integrations
    description: Sync orders, products, customers, and invoices to SAP, Oracle NetSuite, Odoo, Zoho Books, QuickBooks, or
      custom accounting systems.
  - name: Custom Storefronts and Themes
    description: Build custom Twilight themes or headless storefronts that render Salla catalog and checkout through a fully
      custom front end.
  - name: Shipping Provider Onboarding
    description: Logistics companies expose their pickup, label printing, tracking, and return surface as a Salla Shipping
      App to serve every merchant on the platform.
  - name: Marketing and CRM Automation
    description: Subscribe to customer, order, and abandoned-cart webhooks to drive CRM, email, SMS, and WhatsApp campaigns
      through Mailchimp, Klaviyo, or in-house automation.
  - name: AI Shopping Assistants
    description: Use the Merchant API plus Naftiko capabilities to power AI agents that browse catalog, place orders, track
      shipments, and respond to merchant questions.
  - name: ZATCA Compliance
    description: Generate the Saudi ZATCA Phase-1 / Phase-2 e-invoicing QR code on every receipt to remain compliant with
      Saudi Arabian tax authority requirements.
- type: Integrations
  data:
  - name: STC Bank
    description: Native STC Bank digital wallet payment option across all Salla-powered stores.
  - name: Tabby and Tamara
    description: Buy-now-pay-later integrations widely used in the GCC market.
  - name: Apple Pay and mada
    description: Apple Pay and the Saudi mada national payment network.
  - name: HyperPay and Moyasar
    description: Regional payment gateways supporting cards, wallets, and bank transfers.
  - name: Aramex, SMSA, J&T, DHL
    description: Pre-built shipping integrations for Saudi Arabia and GCC delivery.
  - name: ZATCA
    description: Saudi Arabian Zakat, Tax and Customs Authority e-invoicing.
  - name: WhatsApp Business
    description: Customer notifications and conversational commerce.
  - name: Mailchimp and Klaviyo
    description: Email and customer marketing automation.
  - name: Snapchat and TikTok Pixels
    description: Storefront pixels and conversion tracking for GCC-focused ad platforms.
- type: Solutions
  data:
  - name: Sellers
    description: Merchants of any size launching an online store with Arabic-first UX, regional payments, and built-in logistics.
  - name: Partners
    description: Developers and agencies building apps, themes, and integrations distributed through the Salla Partners Portal
      and App Store.
  - name: Shipping Companies
    description: Logistics providers offering their service to 80,000+ merchants by implementing the Salla Shipping App contract.
  - name: Enterprise
    description: Larger brands needing custom themes, dedicated infrastructure, and bespoke commercial terms.
created: '2026-05-24'
modified: '2026-05-24'
position: Producing
description: Salla is a Saudi Arabia-based e-commerce platform — often called the Shopify of the Middle East — that lets merchants
  launch, operate, and grow Arabic-first online stores without code. Founded in 2016 in Makkah by Nawaf Hariri and Salman
  Butt, Salla now powers more than 80,000 active stores. The platform exposes a Merchant REST API (https://api.salla.dev/admin/v2),
  an OAuth 2.0 Partners authorization service, signed webhooks for the full storefront lifecycle, a Shipping and Fulfillment
  app contract, the Twilight theme engine and JavaScript SDK, the Salla CLI, and official starter kits for PHP/Laravel and
  Node.js/Express. Backed by Sanabil (PIF), STV, Investcorp, Vision Ventures, and Raed Ventures, Salla raised a $130M pre-IPO
  round in 2024.
maintainers:
- FN: Kin Lane
  email: info@apievangelist.com
  X: apievangelist
  url: https://apievangelist.com
specificationVersion: '0.16'