Bulk Product Actions

Production

POST

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

Products

Last modified:2025-02-04 08:45:24

This endpoint allows you update multiple products with various actions.

If only one product is specified, the update will be applied immediately. For multiple products, the updates will be processed through a queue.

Scopes

products.read_write- Products 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

operations

array [object {2}]

required

action_name

enum<string>

optional

Product's action name signifying the action to perform based on the filters.

Allowed values:

duplicatesale-channelsfeaturesnotify-quantitypricing

value

object

optional

An array that will hold information based on the action type.

filters

object

required

select_all

boolean

optional

Whether ot not to select all products

unselected_ids

array[string]

optional

Exclude IDs from selections

ids

array[integer]

optional

List of product IDs that you wish to apply the actions on. List of products IDs can be found here.

categories

array[string]

optional

Filter using the categories that you wish to update product in.

brands

array[string]

optional

Filter using brand ID(s) that you with to update products in. List of brands IDs can be found here.

wholesale

boolean

optional

mahly

enum<string>

optional

Allowed values:

linkedunlinked

status

array[string]

optional

Filter using product status.

Allowed values:

hiddenoutsalenone

types

array[string]

optional

Filter using product type

Allowed values:

productservicegroup_productsfinancial_supportcodesdigitalfooddonatingbooking

Example

{
  "operations": [
    {
      "action_name": "duplicate"
    },
    {
      "action_name": "sale-channels",
      "value": {
        "channels": [
          "web",
          "app"
        ]
      }
    },
    {
      "action_name": "features",
      "value": {
        "mahly_category_id": 5670235101,
        "categories": [
          537348185
        ],
        "brand_id": 959852531,
        "tags": [
          1982584825
        ]
      }
    },
    {
      "action_name": "notify-quantity",
      "value": {
        "notify_quantity": 10,
        "minimum_notify_quantity": 20,
        "subscribers_percentage": 5
      }
    },
    {
      "action_name": "pricing",
      "value": {
        "column": "price",
        "formula": "price - (price * amount /100 )",
        "amount": 50,
        "apply_on": "product"
      }
    }
  ],
  "filters": {
    "select_all": false,
    "unselected_ids": [],
    "ids": [
      1661028235,
      388819608
    ],
    "categories": [
      48702356,
      12857436
    ],
    "brands": [
      716569785,
      125713981
    ],
    "wholesale": false,
    "mahly": "unlinked",
    "status": [
      "sale"
    ],
    "types": [
      "product",
      "digital"
    ]
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.salla.dev/admin/v2/products/actions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "operations": [
        {
            "action_name": "duplicate"
        },
        {
            "action_name": "sale-channels",
            "value": {
                "channels": [
                    "web",
                    "app"
                ]
            }
        },
        {
            "action_name": "features",
            "value": {
                "mahly_category_id": 5670235101,
                "categories": [
                    537348185
                ],
                "brand_id": 959852531,
                "tags": [
                    1982584825
                ]
            }
        },
        {
            "action_name": "notify-quantity",
            "value": {
                "notify_quantity": 10,
                "minimum_notify_quantity": 20,
                "subscribers_percentage": 5
            }
        },
        {
            "action_name": "pricing",
            "value": {
                "column": "price",
                "formula": "price - (price * amount /100 )",
                "amount": 50,
                "apply_on": "product"
            }
        }
    ],
    "filters": {
        "select_all": false,
        "unselected_ids": [],
        "ids": [
            1661028235,
            388819608
        ],
        "categories": [
            48702356,
            12857436
        ],
        "brands": [
            716569785,
            125713981
        ],
        "wholesale": false,
        "mahly": "unlinked",
        "status": ["sale"],
        "types": ["product", "digital"]
    }
}'

Responses

🟢200Success

application/json

Body

status

number

required

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

required

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

array[object (BulkProductActions) {3}]

required

operation_id

string

required

Product operation unique identification.

action_name

string

required

Bulk operation name.

status

string

required

Operation status.

Example

{
  "status": 200,
  "success": true,
  "data": [
    {
      "operation_id": "9cde43d8-dbac-40f4-8d39-74a9443846b9",
      "action_name": "notify-quantity",
      "status": "in_progress"
    },
    {
      "operation_id": "9cde43d8-dbba-47cd-98ed-23bb3aeee142",
      "action_name": "mahly-category",
      "status": "in_progress"
    }
  ]
}

🟠422Validation Error

🟠401unauthorized

Modified at 2025-02-04 08:45:24

Import Products

Product Options