Salla

aid: salla
url: https://raw.githubusercontent.com/api-evangelist/salla/refs/heads/main/apis.yml
apis:
- aid: salla:salla-merchant-api
  name: Salla Merchant API
  tags:
  - E-Commerce
  - Merchant
  - Orders
  - Products
  - Customers
  humanURL: https://docs.salla.dev/421117m0
  baseURL: https://api.salla.dev/admin/v2
  properties:
  - url: https://docs.salla.dev/421117m0
    type: Documentation
  - url: https://docs.salla.dev/5394168e0
    name: List Products
    type: Documentation
  - url: https://docs.salla.dev/5394147e0
    name: Order Details
    type: Documentation
  - url: openapi/salla-merchant-api-openapi.yml
    type: OpenAPI
  - 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: JSONSchema
  - url: json-ld/salla-context.jsonld
    type: JSON-LD
  - url: examples/salla-list-products-example.json
    type: Example
  - url: examples/salla-create-order-example.json
    type: Example
  - type: NaftikoCapability
    url: capabilities/merchant-products.yaml
  - type: NaftikoCapability
    url: capabilities/merchant-orders.yaml
  - type: NaftikoCapability
    url: capabilities/merchant-customers.yaml
  - type: NaftikoCapability
    url: capabilities/merchant-categories.yaml
  - type: NaftikoCapability
    url: capabilities/merchant-brands.yaml
  - type: NaftikoCapability
    url: capabilities/merchant-shipping.yaml
  description: RESTful endpoints purpose-built for secure, fast, and easy access to Merchant data. Covers products,
    orders, customers, branches, brands, categories, coupons, currencies, languages, taxes, shipping zones, shipments,
    abandoned carts, marketing, and store configuration. All requests use the base URL https://api.salla.dev/admin/v2
    and are authenticated with an OAuth 2.0 bearer token issued via Salla Partners.
- aid: salla:salla-apps-api
  name: Salla Apps API
  tags:
  - Apps
  - E-Commerce
  - OAuth
  - Subscriptions
  humanURL: https://docs.salla.dev/421118m0
  baseURL: https://accounts.salla.sa
  properties:
  - url: https://docs.salla.dev/421118m0
    type: Documentation
  - url: openapi/salla-apps-api-openapi.yml
    type: OpenAPI
  - type: NaftikoCapability
    url: capabilities/apps-oauth.yaml
  - type: NaftikoCapability
    url: capabilities/apps-subscriptions.yaml
  description: Manages app settings, OAuth 2.0 authorization flow, access and refresh tokens, merchant user info,
    subscription lifecycle, and app event handling for apps installed from the Salla Partners Portal. OAuth endpoints
    live at https://accounts.salla.sa/oauth2/{auth,token,user/info}.
- aid: salla:salla-shipping-fulfillment-api
  name: Salla Shipping and Fulfillment API
  tags:
  - E-Commerce
  - Fulfillment
  - Shipping
  - Shipments
  humanURL: https://docs.salla.dev/5394234e0
  baseURL: https://api.salla.dev/admin/v2
  properties:
  - url: https://docs.salla.dev/5394234e0
    name: Shipment Details
    type: Documentation
  - url: https://docs.salla.dev/5394248e0
    name: Shipping Zone Details
    type: Documentation
  - url: openapi/salla-shipping-fulfillment-api-openapi.yml
    type: OpenAPI
  - type: NaftikoCapability
    url: capabilities/shipping-shipments.yaml
  - type: NaftikoCapability
    url: capabilities/shipping-zones.yaml
  description: Enables shipping companies and fulfillment partners to manage and track shipments, shipping zones,
    pickup branches, and courier integrations for Salla merchant stores. Implements the Shipping App contract that
    Salla calls into when a merchant creates or cancels a shipment.
- 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: SDK
    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).
name: Salla
tags:
- Arabic
- E-Commerce
- GCC
- Headless Commerce
- Merchant
- MENA
- Online Stores
- Retail
- Saudi Arabia
- SMB
- Storefront
kind: contract
image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
access: 3rd-Party
common:
- 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:[email protected]
  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: SDK
- url: https://github.com/SallaApp/express-starter-kit
  name: Express.js Starter Kit
  type: SDK
- url: https://github.com/SallaApp/oauth2-merchant
  name: OAuth2 Merchant Client (PHP)
  type: SDK
- url: https://github.com/SallaApp/passport-strategy
  name: Passport OAuth Strategy (Node.js)
  type: SDK
- url: https://github.com/SallaApp/webhook-actions-js
  name: Webhook Actions (Node.js)
  type: SDK
- url: https://github.com/SallaApp/ZATCA
  name: ZATCA (Fatoora) E-Invoicing QR Code (PHP)
  type: SDK
- 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: Forum
- 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: [email protected]
  X: apievangelist
  url: https://apievangelist.com
specificationVersion: '0.16'