Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
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.

agent ready

Reference-quality API operations across every facet — a rich contract, published governance, transparent operations, and machine-readable commercial terms.

Kin Score

API Evangelist profiles Salla the way a machine reads it — 80 machine-readable artifacts across 18 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.

Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — Salla scores 75.1/100 (exemplar), with a separate agent-readiness read of 54/100 (agent ready). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.

Kin Score

This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 75.1/100 · exemplar
Contract Quality 17.0 / 25
Developer Ergonomics 15.7 / 20
Commercial Clarity 14.2 / 20
Operational Transparency 8.9 / 13
Governance 10.4 / 12
Discoverability 8.8 / 10
Regulatory · Payments 11.4 / 15
Agent readiness — 54/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
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

How we profile Salla

Each block below is one kind of artifact we hold for Salla. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.

APIs 18

Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.

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 within the panel for all 18 ·

Postman Collections 2

A runnable collection turns the contract into something a developer can execute in seconds. We profile them because the fastest way to trust an API is to make a real call against it.

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

Open Collections 4

Open, tool-agnostic collections carry the same runnable value as Postman without locking you to one client — the portable, forkable form of the same exercise.

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

Real integrations are rarely a single call. Arazzo describes the multi-step sequences — auth, then create, then confirm — so both a human and an agent can follow the choreography, not just the endpoints.

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 within the panel for all 11 ·

Pricing Plans 1

Pricing is part of the interface. Machine-readable plans tell you what a tier costs and includes before you commit — one of the six things the Kin Score reads for commercial clarity.

Published pricing tiers and plan structures.

Salla Plans Pricing

5 plans

PLANS

Rate Limits 1

Rate limits are the difference between a demo that works and a production integration that doesn't fall over. Publishing them is an operational-transparency signal — and a hard requirement for any agent that plans its own throughput.

Documented rate limits and quota policies.

Salla Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals let a buyer model the financial operations of an API before it's live. We profile them for the same reason we profile pricing: the money is part of the contract.

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

Salla Finops

FINOPS

Features 10

The notable capabilities this provider advertises, captured as structured features so they can be searched and compared instead of read one landing page at a time.

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 within the panel for all 10 ·

Semantic Vocabularies 1

JSON-LD contexts give the data shared meaning across APIs. We profile them because semantics are what let a machine reconcile 'customer' here with 'customer' somewhere else.

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

Salla Context

0 classes · 5 properties

JSON-LD

Spectral Rules 2

Governance rulesets we run against this provider's specs — the automated checks behind parts of the score. Profiling them makes the quality bar explicit and re-runnable, not a matter of opinion.

Salla API Rules

5 rules · 4 warnings

SPECTRAL

Salla API Rules

9 rules · 3 errors · 3 warnings

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions describe the data models behind the API. We profile them so the shapes are validatable on their own — useful long after a single request is forgotten.

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

Real request and response payloads are what turn a spec from abstract into obvious — and they're one of the twelve things an agent needs to call an API correctly on the first try.

Example request and response payloads for these APIs.

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.

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 are the vocabulary of least-privilege access. Profiling them shows exactly what an integration — or an agent acting on a user's behalf — is allowed to do.

OAuth scopes governing access to this provider's APIs.

Salla Scopes

11 scopes · authorizationCode

11 scopes

SCOPES

Agentic Access 1

An x-agentic-access contract marks which operations are safe for an agent to run on its own and which need a human in the loop. It is the difference between an API an agent can use and one it can use safely.

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 actually build with this provider — captured so the catalogue answers 'what is this for', not just 'what does this expose'.

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 within the panel for all 7 ·

Integrations 9

Pre-built integrations with other platforms tell you where this provider already fits in a stack.

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 within the panel for all 9 ·

Solutions 4

Packaged solutions the provider offers on top of the raw API surface.

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

Every other property we hold for Salla — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.

Get Started 4

Portal, sign-up, and the first successful call

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Access & Security 3

Authentication, authorization, and security posture

Learn 1

Tutorials, courses, talks, and written guidance

Company 3

The organization behind the API

← All providers · Data indexed from github.com/api-evangelist/salla · machine-readable index on apis.io