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. Webhooks - Store Events
  • 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. Webhooks - Store Events

Product

Below are the webhook store events paired with their respective data schema related to the Product webhook events:

Product Webhook Events Model#

The following includes 5 product webhook events that share the same model, which are mentioned in the event enum value under the Data Schema tab
Data Schema
Example
Product Webhook Events Model
event
enum<string> 
optional
Event Name
Allowed values:
product.createdproduct.updatedproduct.deletedproduct.availableproduct.quantity.low
merchant
number 
optional
Merchant ID who installed the application on their store. Get details on the Merchant via the ID using the endpoint here
created_at
string 
optional
Timestamp of the created Event
data
object (ProductDetails) 
optional
Detailed structure of the Product model object showing its fields and data types.
id
number 
required
A unique identifier for a specific product within a database.
promotion
object 
required
Product promotion details
sku
string 
required
Stock Keeping Unit is a unique alphanumeric code used to identify and manage specific products within a company's inventory.
mpn
string  | null 
required
Manufacturer Part Number (MPN) is a unique identifier assigned by manufacturers to products.
Example:
45343
gtin
string  | null 
required
"Global Trade Item Number" (GTIN), a unique and standardized identifier used to uniquely represent products in the global marketplace.
Example:
14643439
type
enum<string> 
required
The categorization of a product based on its characteristics, features, or intended use.
Allowed values:
productservicegroup_productscodesdigitalfooddonatingbooking
name
string 
required
A label for an item, aiding in easy identification and categorization within a product listing. 🌐 Supports multi-language
short_link_code
string 
required
A short and simplified alphanumeric code or URL used to provide a quick and easy way to access or share a specific product's webpage or information.
urls
object (Urls) 
required
To help companies and merchants, Salla provides a “urls” attribute that has been added to different modules to guide the merchants to have the full URL of this module from both scopes, the dashboard scope as a store admin, and as a customer.
price
object 
required
taxed_price
object 
required
pre_tax_price
object 
required
Product price details before the tax is applied.
tax
object 
required
Product tax price details
description
string 
required
A detailed information about an item. 🌐 Support multi-language
quantity
integer 
required
The number of items available in stock.
unlimited_quantity
boolean 
required
Whether or not the product is of unlimited quantity.
status
enum<string> 
required
Product status refers to the current state of availability of a particular item within a product catalog or inventory.
Allowed values:
saleouthiddendeleted
is_available
boolean 
required
Whether or not the product is available.
views
integer 
required
The total number of times a specific product has been viewed by users.
sale_price
object 
required
The information about the discounted price or special pricing for a product.
sale_end
string 
required
The date or time when a promotional sale or discount on a product is scheduled to expire.
require_shipping
boolean 
required
Whether or not the product necessitates a physical delivery process or can be provided digitally without shipping.
cost_price
number 
required
The amount a business pays to acquire or manufacture a product before any additional expenses, such as overhead or markup, are applied
weight
number 
required
The weight of the product represented in numerical form if applicable.
weight_type
enum<string> 
required
The classification or unit of measurement used to specify the weight of an object or item, such as kilograms (kg), pounds (lb), ounces (oz), or grams (g).
Allowed values:
kgglboz
with_tax
boolean 
required
Whether or not a tax applied to this product or not.
url
string 
required
The hyperlink that leads to a specific product's page.
images
array [object {9}] 
required
Visual representations or pictures of a product, to showcase its appearance, features, and details to potential customers.
sold_quantity
integer 
required
The total number of items of the product that have been purchased or sold over a certain period.
rating
object 
required
Product rating details, include information about the ratings and reviews provided by customers for a specific product.
regular_price
object 
required
Product regular price details.
max_items_per_user
number 
required
The limit set on the number of products that an individual user is allowed to purchase.
maximum_quantity_per_order
number  | null 
required
Maximum quantity per order for the customer or the maximum quantity for the product.
show_in_app
boolean 
required
Whether or not to show the product in the App.
notify_quantity
string  | null 
required
Notify quantity of the product.
hide_quantity
boolean 
required
Whether or not to hide the product quantity.
channels
array[string]
required
The product to appear in specific channels.
Allowed values:
appweb
managed_by_branches
boolean 
required
Whether or not to indicate if the product is managed by branches.
service_blocks
object 
required
External services for the prodcut.
calories
string  | null 
required
Calories amount of the product.
Example:
500.00
starting_price
object 
required
The merchant owner should activate this feature from his store from here.
Example:
500.00
allow_attachments
boolean 
required
Whether or not to allow adding attachments to the prodcut details.
is_pinned
boolean 
required
Whether or not to show if the prodcut is pinned.
pinned_date
string 
required
The date which the product was pinned at.
sort
number 
required
Sorting order of the product.
active_advance
boolean 
required
Whether or not to activate advance product details.
enable_upload_image
boolean 
required
Whether or not to allow image uploading.
updated_at
string 
required
Product last updated date.
options
array[object (MiniProductOption) {13}] 
required
The additional choices that can be selected to customize the product according to preferences.
skus
array[object (ProductVariant) {21}] 
required
Product variants SKUs details
metadata
object 
required
The data that describes other data, providing details on its creation, format, and context.
booking_details
object 
required
The information related to a specific booking, such as date, time, location, and other relevant particulars
categories
array[object (Category) {14}] 
required
The various sections or attributes that describe a product, such as name, price, description, specifications, and availability.
brand
object (Brand) 
required
Detailed structure of the brand model object showing its fields and data types.
tags
array [object {2}] 
required

Product Channels Changed Webhook Events Model#

This event is triggered when a product channel has been changed.
Data Schema
Example
Products Channel Changed Webhook Event Model
event
enum<string> 
optional
Event Name
Allowed value:
product.channels.changed
merchant
integer 
optional
Merchant ID who installed the application on their store. Get details on the Merchant via the ID using the endpoint here
created_at
string 
optional
Timestamp of the created Event
data
object 
optional
id
integer 
required
Product ID
channels
array[string]
required
The product to appear in specific channels
Allowed values:
appwebvendorsmahly
Modified at 2025-03-04 12:54:02
Previous
Order
Next
Customer