Salla Docs
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Merchant API
  • Merchant API
  • Salla OAuth 2.0
Partner APIs
  • App API
  • Shipment API
Storefront
  • Twilight Engine
  • Twilight SDK
  • Web Components
  • Change Log
Salla CLI
Salla - Opensource
Salla - Developers Community
  1. Merchant API
  • Welcome 👋
  • Get Started
  • Create Your First App
  • Authorization
  • Webhooks
  • Conditional Webhooks
  • Security Considerations
  • Multi-Language Support
  • Responses
  • Pagination
  • Rate Limiting
  • Versioning
  • Change Log
  • Support
  • APIs
    • Orders
      • Create Order
      • List Orders
      • Order Details
      • Create Drafted Order
      • Update Order
      • Duplicate Order
      • Order Actions
    • Order Status
      • Update Order Status
      • Create Custom Order Status
      • List Order Statuses
      • Order Status Details
      • Update Custom Order Status
      • Update Bulk Orders Statuses
      • Sort Orders Statuses
    • Order Histories
      • List Order Histories
      • Create Order History
    • Order Tags
      • Create Order Tag
      • List Order Tags
      • Delete Order Tag
    • Order Invoice
      • Create Invoice
      • List Invoices
      • Invoice Details
      • Send Order Invoice
      • Create Order Invoice
    • Order Reservations
      • List Order Reservations
    • Order Items
      • List Order Items
      • Create Order Item
      • Update Order Item
      • Delete Order Item
    • Products
      • Create Product
      • List Products
      • Product Details
      • Update Product
      • Delete Product
      • Change Product Status
      • Product Details By SKU
      • Update Product By SKU
      • Delete Product By SKU
      • Update Product Price By SKU
      • Update Bulk Product Prices
      • Import Products
      • Bulk Product Actions
    • Product Options
      • Create Product Option
      • Product Option Details
      • Update Product Option
      • Delete Product Option
    • Product Quantity
      • List Product Quantities
      • Update Bulk Quantities
      • List Quantity Change Reasons
      • List Quantity Audit
      • Update Bulk Quantities by SKU
      • Update Quantity
      • Update Quantity By SKU
    • Product Variants
      • List Product Variants
      • Product Variant Details
      • Update Product Variant
      • Update Product Variant Quantity
    • Product Tags
      • Create Product Tag
      • List Product Tags
    • Product Images
      • Attach Image by SKU
      • Attach Video by SKU
      • Attach Youtube Video
      • Attach Image
      • Update Image
      • Delete Image
    • Product Option Values
      • Create Product Option Value
      • Product Option Value Details
      • Update Product Option Value
      • Delete Product Option Value
    • Abandoned Carts
      • List Abandoned Carts
      • Abandoned Cart Details
    • Customer Groups
      • Create Customer Group
      • List Customer Groups
      • Add Customers To Group Customer
      • Update Default Customer Group
      • Update Customer Group
      • Delete Customer Group
    • Customers
      • Create Customer
      • List Customers
      • Customer Details
      • Update Customer
      • Delete Customer
      • Ban Customer
      • Un-Ban customer
      • Import Customers
    • Digitals Product
      • Attach Digital Code
      • Attach Digital File
      • Delete Digital File
    • Categories
      • Create Category
      • List Categories
      • Category Details
      • Update Category
      • Delete Category
      • Category Children
      • Categories Search
      • List Category Products
    • Exports
      • Export Orders
      • Exports Logs
      • List Export Templates
      • Create Export Template
      • Update Export Template
      • Delete Export Template
      • List Export Columns
      • Export Customers
      • Export Custom URLs
      • Export Products
    • Shipments
      • Create Shipment
      • List Shipments
      • Shipment Details
      • Shipment Tracking
      • Update Shipment Details
      • Cancel Shipment
      • Return Shipment
    • Shipping Companies
      • List Shipping Companies
      • Shipping Company Details
      • List Estimate Rates
      • Create Shipping Company
      • Update Shipping Company
      • Delete Shipping Company
      • Shipping Company Options
    • Shipping Zones
      • Create Shipping Zone
      • List Shipping Zones
      • Shipping Zone Details
      • Update Shipping Zone
      • Delete Shipping Zone
    • Shipping Rules
      • List Shipping Rules
      • Shipping Rule Details
      • Delete Shipping Rule
    • Countries
      • List Countries
      • Country Details
    • Product Option Templates
      • List Option Templates
      • Option Template Details
      • Delete Option Template
      • Update Option Template
      • Create Option Template
    • Taxes
      • Create Tax
      • List Taxes
      • Tax Details
      • Update Tax
      • Delete Tax
    • Coupons
      • Create Coupon
      • List Coupons
      • Coupon Details
      • Update Coupon
      • Delete Coupon
      • List Coupon Codes
    • Affiliates
      • List Affiliates
      • Affiliate Details
      • Create Affiliate
      • Update Affiliate
      • Delete Affiliate
    • Order Assignment
      • List Auto Assignment Rules
      • Order Assigned Employees Details
      • Update Auto Assignment Rule
      • Create Auto Assignment Rules
    • Special Offers
      • Create Special Offer
      • List Special Offers
      • Special Offer Details
      • Update Special Offer
      • Delete Special Offer
      • Change Special Offer Status
    • Transactions
      • List Transactions
      • Transaction Details
      • Update Transaction
    • Payments
      • Available Payment Methods
      • List Banks
      • Payment Bank Details
    • Settlements
      • List Instant Settlements
      • Create Instant Settlement
      • Update Instant Settlement
      • Instant Settlement Details
    • Settings
      • Settings List
      • Update Setting Slug
      • Setting Details
    • Merchant
      • User Information Details
      • Store Information
    • Brands
      • Create Brand
      • List Brands
      • Brand Details
      • Update Brand
      • Delete Brand
    • Branches
      • Create Branch
      • List Branches
      • Branch Details
      • Update Branch
      • Delete Branch
    • Currencies
      • Activate Currencies
      • List Currencies
      • List Available Currencies
    • SEO
      • List SEO Settings
      • Update SEO Settings
    • Cities
      • List Cities
    • DNS Records
      • List DNS Records
      • Create DNS Record
      • Delete DNS Record
    • Languages
      • Add Language
      • List Languages
      • Update Language
    • Employees
      • List Employees
    • Advertisements
      • Create Advertisement
      • List Advertisements
      • Advertisement Details
      • Update Advertisement
      • Delete Advertisement
    • Webhooks
      • List Active Webhooks
      • List Events
      • Register Webhook
      • Deactivate Webhook
      • Update Webhook
    • Custom URLs
      • Import Custom URLs
    • Loyalty Points
      • Customer Loyalty Points
      • Update Customer Loyalty Points
    • Reviews
      • List Reviews
      • Review Details
      • Update Review
  • Webhooks - Store Events
    • Order
    • Product
    • Customer
    • Shippings
    • Shipments
    • Brand
    • Invoice
    • Category
    • Store
    • Special Offer
    • Cart
    • Miscellaneous
  1. Merchant API

Create Your First App

Salla has made it easier for developers worldwide to reach its audience of over 60,000 active retailers. Achieve more and make money by offering your services to many Merchants or by engaging them in high-touch customer interactions. You can do more, as we explained in a previous article.
Note
Developers can access a rich list of Salla's Partners resources using the dedicated API documentation, which provides in-depth access methods to Salla customers, stores, and more.
With the Partners Portal, you can create Apps, test on demo stores, release them on the Salla Apps Marketplace and get paid.
Information
The Salla Partner Portal gives more capabilities for developers to design, develop, build, ship, and connect their apps with the Salla E-commerce portal.
As we will be unraveling in this article, the portal will be much more effortless to workaround.

Create Salla App#

To start, make sure to have a verified Salla Partners account on https://salla.partners.
Login to your account on https://salla.partners using your credentials. Once logged in you will be redirected to the main page.
From the left menu, can click on "My Apps". This will land on the Apps page where you can create your first app.
Note
With Salla App Store, you can have two types of Apps:
Public App: your App can go into public usage and display for those users who browse the Salla App Store. The Merchants can view your App's details and may download/purchase your App.
Private App: privately built and developed apps for integration to either larger scaled or individual Merchants. The Apps won't be displayed or accessed from the Salla App Store homepage search results and more.
In this step, you will need to choose your App's type either Public or Private.
Note
Shipping App can be a Public or Private App, you will be able to choose the App category in the next section.
Afterward, start entering the basic information of your App:
ItemDescription
IconThe App icon image, should have Minimum width : 250 pixels, height : 250 pixels. And the Width to high ratio : 1 : 1 .
NameThe App name should be provided in English and Arabic
CategoryShipping Apps for Shipping services Apps., General App for other than Shipping App
DescriptionDescribe your App in 50 characters
App WebsiteThe App website URL link
Support EmailThe App support email address
Following is a complete example for App Basic information:
image
Now you can click on "Create App".
🥳You have successfully created your first App on Salla Partners Portal.
Note
Getting here, means the App was created. In order to publish you will need to continue reading.

App Details#

After creating the App, you will be redirected to the App details page. App Details page is where you will find the App deatils inlcuding App Keys, App Scope, Webhooks Notifications App Trusted IP's, App Settings, App Snippet, Custom Plans, DNS Management, App Testing, App Testing, App Publishing. Each section will be explained in the following parts.
1- App Keys#
The App keys details are required to authorize your App via Merchants. Such credentials include:
Client ID
Client Secret Key with an option to generate a new Client secret key
OAuth Modes, either Easy Mode as in-house authorization or Custom Mode.
2- App Scope#
After that, you will come to the "App Scope" section. This section specifies your app's scope to protect your app by identifying and restricting access to certain features and services.
3- Webhooks and Notifications#
Next, you will have the "Webhooks/Notifications". Webhooks are one way that Apps can send automated messages or information to other apps. You can use that to be notified whenever events occur in stores, such as "create an order", "register a new customer", and others. Scrolling down, you will outlook more options:
Adding your Webhook URL to where you will be receiving the events you choose to listen to
Get your Webhook Secret key with the option to generate a new one
Stream App Events
Add Store Events
a. App Events#
For App Events, your webhook will automatically receive the events when a merchant triggers an action on your app, such as:
App Installed
App Updated
App Trial Started
App Trial Ended
App Subscription Started
App Subscription Ended
App Subscription Renewed
App Rated
b. Store Events#
For adding Store Events, Salla has listed out events you can listen to with each having its own attributes, such as:
Orders
Products
Customers
Categories
Brands
Stores
Miscellaneous
4- App Trusted IP#
In this section, you can add a trusted IPs for your App for more secure communication between the App and Salla API
5- App Snippets#
The App snippets can be added in this section. Click on "View Snippets" to start adding.
Read more about App Snippets here.

6- App Settings#
In this section you can edit the App settings, including buliding the App Settings and Settings Validation URL
you can follow the steps in this article for detailed guidance.

7- Custom Plans#
This feature enables you to create unique plans and features tailored to your specific needs.
Read more about Custom Plans here.

8- DNS Management#
Managing DNS (Domain Name System) records for a Salla Store involves configuring the settings that enable the store’s domain name to be associated with its corresponding IP address, which helps to ensure that visitors can access the store using the desired domain name.
More about DNS Management here

9- App Testing#
In this section you can test your App using a demo store, the demo store will provide a real life experience of an actual store where you can test your App features.
Follow the steps of creating a demo store here

App Publishing#

App publishing allows your App to be displayed in Salla Apps Store for all Salla Merchants.
To publish your App, scroll down on the App Details page and click on the "Start Publishing your App" button, to begin the process.
The publishing process consists of six sections, Basic Information, App Configurations, App Features, Pricing, Contact Information and Service Trial.
Read more about publishing Salla App here.

With that said, we covered the Salla Partner Portal fully, with all its procedures to create your first App on the portal. Follow up with your email and portal notifications for further understanding of the portal.

Your Gateway to Success#

With the steps mentioned above, you will create your first App on Salla with ease and a smooth process.
Time for you to elevate your work, experience, and ability and have a solid reputation with passive income that could be higher than expected, as we have discussed.
If you are facing any issues or have any further questions, be part of the Global Developer Community on Telegram
Modified at 2025-03-04 12:54:02
Previous
Get Started
Next
Authorization