Update Special Offer

Production

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

PUT

/specialoffers/{specialoffer}

Last modified:2026-01-25 14:52:08

This endpoint allows you to update special offer details by passing the specialoffers as a path parameter.

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 ********************

Path Params

Body Params application/json

Example

{
    "name": "Offer with Countries Condition",
    "message": "Buy One Get One Free",
    "applied_channel": "browser_and_application",
    "offer_type": "buy_x_get_y",
    "applied_to": "product",
    "start_date": "2025-12-26",
    "expiry_date": "2026-12-31",
    "min_purchase_amount": 10,
    "min_items_count": 2,
    "buy": {
        "type": "product",
        "min_amount": 10,
        "quantity": 1,
        "products": [
            1462551237
        ]
    },
    "get": {
        "type": "product",
        "discount_type": "percentage",
        "discount_amount": 50,
        "quantity": 1,
        "products": [
            1668259787
        ]
    },
    "countries": [
        566146469,
        1473353380
    ],
    "select_by": "mobile"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.salla.dev/admin/v2/specialoffers/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Offer with Countries Condition",
    "message": "Buy One Get One Free",
    "applied_channel": "browser_and_application",
    "offer_type": "buy_x_get_y",
    "applied_to": "product",
    "start_date": "2025-12-26",
    "expiry_date": "2026-12-31",
    "min_purchase_amount": 10,
    "min_items_count": 2,
    "buy": {
        "type": "product",
        "min_amount": 10,
        "quantity": 1,
        "products": [
            1462551237
        ]
    },
    "get": {
        "type": "product",
        "discount_type": "percentage",
        "discount_amount": 50,
        "quantity": 1,
        "products": [
            1668259787
        ]
    },
    "countries": [
        566146469,
        1473353380
    ],
    "select_by": "mobile"
}'

Responses

🟢200Success

application/json

Body

Example

{
    "status": 200,
    "success": true,
    "data": {
        "id": 476380627,
        "name": "Offer with Countries Condition",
        "message": "Buy One Get One Free",
        "expiry_date": "2026-12-31 00:00:00",
        "start_date": "2026-01-26 00:00:00",
        "offer_type": "buy_x_get_y",
        "status": "inactive",
        "show_price_after_discount": false,
        "show_discounts_table_message": false,
        "countries": [
            566146469,
            1473353380
        ],
        "customer_groups": [],
        "applied_to": "product",
        "select_by": "mobile",
        "options": [],
        "based_on": null,
        "buy": {
            "type": "product",
            "quantity": 1,
            "products": []
        },
        "get": {
            "type": "product",
            "discount_type": "percentage",
            "quantity": "1",
            "products": [],
            "discount_amount": "50.00"
        },
        "tiers": [],
        "apply_type": null,
        "with_current_cart": false,
        "special_price": null,
        "applied_with_coupon": false,
        "scopes": [],
        "exclude_sale_items": false,
        "excluded_buy_products_ids": [],
        "excluded_buy_categories_ids": []
    }
}

🟠404Not Found

🟠422Error Validation

🟠401Unauthorized

Modified at 2026-01-25 14:52:08

Special Offer Details

Delete Special Offer