Actions150
- Branches Actions
- Carts Actions
- Catalog Actions
- Customers Actions
- Add Customers To Group Customer
- Create Customer Group
- Delete Customer Group
- List Customer Groups
- Update Customer Group
- Ban Customer
- Create Customer
- Customer Details
- Delete Customer
- List Customers
- Un-Ban customer
- Update Customer
- Customer Loyalty Points
- Update Customer Loyalty Points
- List Reviews
- Review Details
- Update Review
- Finance Actions
- Locations Actions
- Marketing Actions
- Merchant Actions
- Orders Actions
- List Auto Assignment Rules
- Order Assigned Employees Details
- Create Order History
- List Order Histories
- Create Invoice
- Create Order Invoice
- Invoice Details
- List Invoices
- Send Order Invoice
- Create Order Item
- Delete Order Item
- List Order Items
- Update Order Item
- List Order Reservations
- Create Custom Order Status
- List Order Statuses
- Order Status Details
- Update Custom Order Status
- Update Order Status
- Create Order
- Duplicate Order
- List Orders
- Order Actions
- Order Details
- Relocate Order Stock
- Update Order
- Products Actions
- Attach Digital Code
- Attach Digital File
- Delete Digital File
- Attach Image
- Attach Video by SKU
- Attach Youtube Video
- Delete Image
- Update Image
- List Product Quantities
- List Quantity Audit
- List Quantity Change Reasons
- Update Bulk Quantities
- Delete Option Template
- List Option Templates
- Option Template Details
- Create Product Option Value
- Delete Product Option Value
- Product Option Value Details
- Update Product Option Value
- Create Product Option
- Delete Product Option
- Product Option Details
- Update Product Option
- Create Product Tag
- List Product Tags
- List Product Variants
- Product Variant Details
- Update Product Variant
- Change Product Status
- Create Product
- Delete Product
- Delete Product By SKU
- List Products
- Product Details
- Product Details By SKU
- Update Product
- Update Product By SKU
- Update Product Price By SKU
- Shipping Actions
Marketing → Create Coupon
AI-generatedSummary
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.