Create Special Offer

POST https://api.salla.dev/admin/v2/specialoffers

This endpoint allows you to create a new special offer and return the created special offer id and its details.

💡 Note

More details of body samples of differnt types of offers are listed in this link.

Request Body

{"name"=>"<string>", "applied_channel"=>"browser_and_application", "offer_type"=>"fixed_amount", "applied_to"=>"product", "expiry_date"=>"<string>", "min_purchase_amount"=>"<number>", "min_items_count"=>"<number>", "buy"=>{"type"=>"category", "min_amount"=>"<number>", "quantity"=>"<number>", "products"=>["<integer>", "<integer>"], "categories"=>["<integer>", "<integer>"], "payment_methods"=>["<integer>", "<integer>"]}, "get"=>{"discount_amount"=>"<number>", "type"=>"category", "discount_type"=>"percentage", "quantity"=>"<number>", "products"=>["<integer>", "<integer>"], "categories"=>["<integer>", "<integer>"]}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;status&quot;:&quot;\u003cnumber\u003e&quot;,&quot;success&quot;:&quot;\u003cboolean\u003e&quot;,&quot;data&quot;:{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;expiry_date&quot;:&quot;\u003cstring\u003e&quot;,&quot;start_date&quot;:&quot;\u003cstring\u003e&quot;,&quot;offer_type&quot;:&quot;fixed_amount&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;show_price_after_discount&quot;:&quot;\u003cboolean\u003e&quot;,&quot;show_discounts_table_message&quot;:&quot;\u003cboolean\u003e&quot;,&quot;buy&quot;:{&quot;type&quot;:&quot;category&quot;,&quot;quantity&quot;:&quot;\u003cnumber\u003e&quot;,&quot;products&quot;:[{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;type&quot;:&quot;service&quot;,&quot;promotion&quot;:{&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;sub_title&quot;:&quot;\u003cstring\u003e&quot;},&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_available&quot;:&quot;\u003cboolean\u003e&quot;,&quot;sku&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;sale_price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;url&quot;:&quot;\u003cstring\u003e&quot;,&quot;has_special_price&quot;:&quot;\u003cboolean\u003e&quot;,&quot;regular_price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;currency&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumbnail&quot;:&quot;\u003cstring\u003e&quot;,&quot;calories&quot;:&quot;\u003cstring\u003e&quot;,&quot;mpn&quot;:&quot;\u003cstring\u003e&quot;,&quot;gtin&quot;:&quot;\u003cstring\u003e&quot;,&quot;favorite&quot;:&quot;\u003cstring\u003e&quot;,&quot;starting_price&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;type&quot;:&quot;service&quot;,&quot;promotion&quot;:{&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;sub_title&quot;:&quot;\u003cstring\u003e&quot;},&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_available&quot;:&quot;\u003cboolean\u003e&quot;,&quot;sku&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;sale_price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;url&quot;:&quot;\u003cstring\u003e&quot;,&quot;has_special_price&quot;:&quot;\u003cboolean\u003e&quot;,&quot;regular_price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;currency&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumbnail&quot;:&quot;\u003cstring\u003e&quot;,&quot;calories&quot;:&quot;\u003cstring\u003e&quot;,&quot;mpn&quot;:&quot;\u003cstring\u003e&quot;,&quot;gtin&quot;:&quot;\u003cstring\u003e&quot;,&quot;favorite&quot;:&quot;\u003cstring\u003e&quot;,&quot;starting_price&quot;:&quot;\u003cstring\u003e&quot;}],&quot;categories&quot;:[{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;urls&quot;:{&quot;customer&quot;:&quot;\u003cstring\u003e&quot;,&quot;admin&quot;:&quot;\u003cstring\u003e&quot;},&quot;items&quot;:[{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Category detected\u003e&quot;}],&quot;parent_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;sort_order&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;hidden&quot;,&quot;metadata_title&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_description &quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_url&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;urls&quot;:{&quot;customer&quot;:&quot;\u003cstring\u003e&quot;,&quot;admin&quot;:&quot;\u003cstring\u003e&quot;},&quot;items&quot;:[{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Category detected\u003e&quot;}],&quot;parent_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;sort_order&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;hidden&quot;,&quot;metadata_title&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_description &quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_url&quot;:&quot;\u003cstring\u003e&quot;}]},&quot;get&quot;:{&quot;type&quot;:&quot;\u003cstring\u003e&quot;,&quot;discount_type&quot;:&quot;percentage &quot;,&quot;quantity&quot;:&quot;\u003cinteger\u003e&quot;,&quot;products&quot;:[{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;type&quot;:&quot;product&quot;,&quot;promotion&quot;:{&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;sub_title&quot;:&quot;\u003cstring\u003e&quot;},&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_available&quot;:&quot;\u003cboolean\u003e&quot;,&quot;sku&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;sale_price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;url&quot;:&quot;\u003cstring\u003e&quot;,&quot;has_special_price&quot;:&quot;\u003cboolean\u003e&quot;,&quot;regular_price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;currency&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumbnail&quot;:&quot;\u003cstring\u003e&quot;,&quot;calories&quot;:&quot;\u003cstring\u003e&quot;,&quot;mpn&quot;:&quot;\u003cstring\u003e&quot;,&quot;gtin&quot;:&quot;\u003cstring\u003e&quot;,&quot;favorite&quot;:&quot;\u003cstring\u003e&quot;,&quot;starting_price&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;type&quot;:&quot;food&quot;,&quot;promotion&quot;:{&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;sub_title&quot;:&quot;\u003cstring\u003e&quot;},&quot;status&quot;:&quot;\u003cstring\u003e&quot;,&quot;is_available&quot;:&quot;\u003cboolean\u003e&quot;,&quot;sku&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;sale_price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;url&quot;:&quot;\u003cstring\u003e&quot;,&quot;has_special_price&quot;:&quot;\u003cboolean\u003e&quot;,&quot;regular_price&quot;:{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;\u003cstring\u003e&quot;},&quot;currency&quot;:&quot;\u003cstring\u003e&quot;,&quot;thumbnail&quot;:&quot;\u003cstring\u003e&quot;,&quot;calories&quot;:&quot;\u003cstring\u003e&quot;,&quot;mpn&quot;:&quot;\u003cstring\u003e&quot;,&quot;gtin&quot;:&quot;\u003cstring\u003e&quot;,&quot;favorite&quot;:&quot;\u003cstring\u003e&quot;,&quot;starting_price&quot;:&quot;\u003cstring\u003e&quot;}],&quot;categories&quot;:[{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;urls&quot;:{&quot;customer&quot;:&quot;\u003cstring\u003e&quot;,&quot;admin&quot;:&quot;\u003cstring\u003e&quot;},&quot;items&quot;:[{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Category detected\u003e&quot;}],&quot;parent_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;sort_order&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;hidden&quot;,&quot;metadata_title&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_description &quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_url&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cnumber\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;urls&quot;:{&quot;customer&quot;:&quot;\u003cstring\u003e&quot;,&quot;admin&quot;:&quot;\u003cstring\u003e&quot;},&quot;items&quot;:[{&quot;value&quot;:&quot;\u003cCircular reference to #/components/schemas/Category detected\u003e&quot;}],&quot;parent_id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;sort_order&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;hidden&quot;,&quot;metadata_title&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_description &quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata_url&quot;:&quot;\u003cstring\u003e&quot;}]}}}