Salla icon

Salla

Execute Salla Merchant API operations through the unified Actions backend.

Actions150

Marketing → Create Coupon

AI-generated

Summary

Create a new coupon in the Salla Merchant platform to offer discounts or special promotions to customers.

Inputs

  • Sub-resource (required) — Specify the sub-resource within the Marketing resource; for Create Coupon, this should be set to 'coupons'.
  • Code (required) — The unique coupon code that customers will enter at checkout to apply the discount.
  • Type (required) — The discount type for the coupon, either 'percentage' for a percent-based discount or 'fixed' for a fixed amount discount.
  • Amount (required) — The discount value; use 0-100 for percentage and currency amount for fixed discounts.
  • Free Shipping (required) — Enable to provide free shipping when the coupon is applied.
  • Exclude Sale Products (required) — Enable to prevent the coupon from being applied to products already on sale.
  • Expiry Date (required) — The last date and time the coupon is valid and can be used.
  • Start Date — The date and time when the coupon becomes active; leave empty for immediate activation.
  • Additional Fields — Optionally define restrictions and additional coupon settings such as product includes/excludes, category includes/excludes, customer group includes/excludes, payment method restrictions, usage limits, minimum and maximum cart amount restrictions, marketing commission settings, and beneficiary domain filtering.
  • Return Mode — Choose to return either only the data payload or the full backend response envelope including status and raw data.

Output shape

a list of response items each containing either the created coupon data or the full backend response envelope based on Return Mode.

Supports multiple input items resulting in multiple response items. If Return Mode is 'dataOnly', output includes only the Salla data payload; if 'fullEnvelope', output includes status, raw data, and other envelope fields. Errors from the API are returned as node errors.

Examples

Example 1: Create a coupon that provides a 15% discount, active immediately, applicable to all products, excludes sale products, with an expiry date and free shipping enabled.

Set resource to Marketing, sub-resource to coupons, operation to Create Coupon. Provide Code (e.g., SAVE15), Type as percentage, Amount 15, Free Shipping true, Exclude Sale Products true, Expiry Date future date. Leave optional fields as needed.

Discussion