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. Special Offers
  • 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
        POST
      • List Special Offers
        GET
      • Special Offer Details
        GET
      • Update Special Offer
        PUT
      • Delete Special Offer
        DELETE
      • Change Special Offer Status
        PUT
    • 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. Special Offers

Create Special Offer

Production
https://api.salla.dev/admin/v2
Production
https://api.salla.dev/admin/v2
POST
https://api.salla.dev/admin/v2
/specialoffers
Special Offers
Last modified:2025-04-17 14:32:46
This endpoint allows you to create a new special offer in the store.
Scopes
specialoffers.read_write- Special Offers Read & Write

Request

Authorization
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Body Params application/json
allOf {2} 
optional
object 
optional
Other Offer Types
name
string 
required
The title or label used to identify a specific promotional or discounted offer. 🌐 Support multi-language
message
string 
optional
A brief statement or communication that conveys the details or benefits of a specific promotional or discount offer. 🌐 Support multi-language
applied_channel
enum<string> 
required
The specific platforms, channels, or methods through which a promotional or special offer is made available or applied.
Allowed values:
browserbrowser_and_application
offer_type
enum<string> 
required
The category or nature of a particular promotional or discount offer, such as buy-x get-y.
Allowed values:
buy_x_get_ypercentagefixed_amountdiscounts_table
applied_to
enum<string> 
required
The specific products, services, or items to which a particular promotional or discount offer is intended or allowed to be used or applied, specifying what the offer covers within a product or service catalog.
Allowed values:
orderproductcategorypaymentMethod
start_date
string <date-time>
optional
The date on which a promotional or discount offer start, before which it is not permitted to take advantage of the offer's benefits.
Ensure to follow on the format of the date.
expiry_date
string <date-time>
optional
The date on which a promotional or discount offer expires or becomes no longer valid, after which it is not permitted to take advantage of the offer's benefits.
Ensure to follow on the format of the date.
min_purchase_amount
number 
optional
The total minimum order amount to be purchased for this offer to be activated
min_items_count
number 
optional
The minimum order items count to activate this offer.
buy
object 
optional
Specifics on items required for offer eligibility.
get
object 
optional
Specifics of the offer.
object 
optional
Discount Table Offer Type
name
string 
required
The title or label used to identify a specific promotional or discounted offer. 🌐 Support multi-language
applied_channel
enum<string> 
required
The specific platforms, channels, or methods through which a promotional or special offer is made available or applied.
Allowed values:
browserbrowser_and_application
offer_type
enum<string> 
required
The category or nature of a particular promotional or discount offer, such as buy-x get-y.
Allowed value:
discounts_table
applied_to
enum<string> 
required
The specific products, services, or items to which a particular promotional or discount offer is intended or allowed to be used or applied, specifying what the offer covers within a product or service catalog.
Allowed values:
orderproductcategory
start_date
string <date-time>
optional
The date on which a promotional or discount offer start, before which it is not permitted to take advantage of the offer's benefits.
Ensure to follow on the format of the date.
expiry_date
string <date-time>
required
The date on which a promotional or discount offer expires or becomes no longer valid, after which it is not permitted to take advantage of the offer's benefits.
Ensure to follow on the format of the date.
status
enum<string> 
optional
Special Offer's status, either active or inactive
Allowed values:
activeinactive
applied_with_coupon
boolean 
optional
Whether or not the offer should be applied with a valid coupon
buy
object 
optional
discounts_table
array [object {2}] 
optional
Tiered discount in the special offer. Required if offer_type is discounts_table
Example
{
  "name": "new offer",
  "message": "Buy One Get One Free",
  "applied_channel": "browser_and_application",
  "offer_type": "buy_x_get_y",
  "applied_to": "product",
  "start_date": "2024-12-30",
  "expiry_date": "2024-12-31",
  "min_purchase_amount": 100,
  "min_items_count": 2,
  "min_items": 0,
  "discounts_table": [
    {
      "quantity": 3,
      "discount_amount": 5
    },
    {
      "quantity": 5,
      "discount_amount": 10
    }
  ],
  "buy": {
    "type": "product",
    "min_amount": 10,
    "quantity": 1,
    "products": [
      401511871
    ]
  },
  "get": {
    "type": "product",
    "discount_type": "percentage",
    "discount_amount": 5,
    "quantity": 1,
    "products": [
      401511871
    ]
  }
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.salla.dev/admin/v2/specialoffers' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "new offer",
    "message": "Buy One Get One Free",
    "applied_channel": "browser_and_application",
    "offer_type": "buy_x_get_y",
    "applied_to": "product",
    "start_date": "2024-12-30",
    "expiry_date": "2024-12-31",
    "min_purchase_amount": 100,
    "min_items_count": 2,
    "min_items": 0,
    "discounts_table": [
        {
            "quantity": 3,
            "discount_amount": 5
        },
        {
            "quantity": 5,
            "discount_amount": 10
        }
    ],
    "buy": {
        "type": "product",
        "min_amount": 10,
        "quantity": 1,
        "products": [
            401511871
        ]
    },
    "get": {
        "type": "product",
        "discount_type": "percentage",
        "discount_amount": 5,
        "quantity": 1,
        "products": [
            401511871
        ]
    }
}'

Responses

🟢200Success
application/json
Body
status
number 
optional
Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.
success
boolean 
optional
Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.
data
object (SpecialOffer) 
optional
Detailed structure of the special offer model object showing its fields and data types.
id
number 
required
A unique identifier associated with a particular promotional or discount offe.
name
string 
required
A descriptive label or title given to a specific promotional offer to distinguish it from others. 🌐 Support multi-language
message
string 
required
A brief statement or communication that conveys the details or benefits of a specific promotional or discount offer. 🌐 Support multi-language
expiry_date
string 
required
The date when a specific promotional or discount offer expires or ends.
Example:
2025-01-01
start_date
string 
required
Special offer start date is the date when a specific promotional or discount offer begins or becomes active.
offer_type
enum<string> 
required
The category or classification that describes a particular promotion, discount, or deal.
Allowed values:
buy_x_get_yfixed_amountpercentagediscounts_table
status
string 
required
The current condition of a specific discount offer, such as whether it is active, expired, or in a pending or inactive status.
show_price_after_discount
boolean 
required
The option to show the price after discount.
show_discounts_table_message
boolean 
required
Whether or not to show information presented in a table format that displays various discounts.
buy
object 
required
Specifics on items required for offer eligibility.
get
object 
required
Specifics of the offer.
Examples
{
  "status": 200,
  "success": true,
  "data": {
    "id": 1935541690,
    "name": "new offer",
    "message": "اشتري قطعة واحصل على قطعة واحدة خصم 5%  من المنتجات التالية",
    "start_date": "2024-12-08 16:00:00",
    "expiry_date": "2025-12-10 16:00:00",
    "offer_type": "buy_x_get_y",
    "status": "inactive",
    "show_price_after_discount": false,
    "buy": {
      "type": "product",
      "quantity": 1,
      "products": [
        {
          "id": 401511871,
          "type": "food",
          "promotion": {
            "title": "Eid Alfitr Offer",
            "sub_title": "Special Promotion"
          },
          "status": "sale",
          "is_available": true,
          "sku": "",
          "name": "بيتزا",
          "price": {
            "amount": 40.25,
            "currency": "SAR"
          },
          "sale_price": {
            "amount": 0,
            "currency": "SAR"
          },
          "currency": "SAR",
          "url": "https://salla.sa/dev-wofftr4xsra5xtlv/بيتزا/p401511871",
          "thumbnail": "https://cdn.salla.sa/bYQEn/hG0U3oATexBxt4j5QjMt8jcNUi12v97KFw9Q1xTA.jpg",
          "has_special_price": false,
          "regular_price": {
            "amount": 40.25,
            "currency": "SAR"
          },
          "calories": "500.00",
          "mpn": "677156713",
          "gtin": "76893972",
          "favorite": "Product is Favourit"
        }
      ]
    },
    "get": {
      "type": "product",
      "discount_type": "percentage",
      "quantity": "1",
      "products": []
    }
  }
}
🟠401Unauthorized
Modified at 2025-04-17 14:32:46
Previous
Create Auto Assignment Rules
Next
List Special Offers