Create a product discount

POST https://api.tamio.com/v2/discounts/product-discount/create

Creates a new product discount with configurable conditions, amounts, and targeting rules. Supports coupons, vouchers, automatic conditions, and quantity/subtotal thresholds.

Note: At least one of amount_off, percent_off, shipping_amount_off, or shipping_percent_off must be greater than zero.

Body Parameters

type string*

product_discount

label string*

Display name for the discount

condition string*

Condition required to activate the discount

all_ordersitem_subtotalitem_quantitycouponvouchers

applies_to string*

What products this discount applies to

selected_productsselected_categoriesall_products

currency string*

Currency code for amount-based discounts (e.g. EUR, USD)

amount_off integer*

Fixed amount discount on product price in smallest currency unit

percent_off number*

Percentage discount on product price (0-100)

shipping_percent_off number*

Percentage discount on shipping cost (0-100)

shipping_amount_off integer*

Fixed amount discount on shipping cost in smallest currency unit

active boolean

Whether the discount is currently active

coupon string

Coupon code (required when condition is "coupon")

coupon_max_redemptions integer

Maximum number of times this coupon can be redeemed (0 for unlimited)

block_affiliates boolean

Whether to block affiliate commissions when this discount is used

voucher_method string

Method for creating vouchers (required when condition is "vouchers")

autogeneratedlist

number_of_vouchers integer

Number of vouchers to auto-generate (required when voucher_method is "autogenerated")

voucher_prefix string

Prefix for auto-generated voucher codes

vouchers array of string

Voucher codes (required when voucher_method is "list")

rule_amount integer

Minimum amount for item/order conditions (required when condition is "item_subtotal" or "item_quantity")

order_condition string

Additional order-level condition

order_subtotalorder_shippingorder_quantity

expiry_date string

Date when the discount expires (null for no expiry)

subscription_discount_duration string

How long the discount applies to subscriptions

onceforeverrepeating

number_of_months integer

Number of months for repeating subscription discounts (required when subscription_discount_duration is "repeating")

duration integer

Duration in months for recurring discounts

products array of string

Product UUIDs (required when applies_to is "selected_products")

categories object

Product categories (required when applies_to is "selected_categories")

destinations array of string

Countries this discount applies to

payments array of string

Payment methods this discount applies to

Responses

200 Product discount created successfully

Product discount created successfully

status integer

discount Discount

400 Validation or business-logic error. Possible `error_code` values:

401 Unauthorized – invalid or missing Bearer token

List all discounts

Create a customer discount

/discounts/product-discount/create

1 const response = await fetch("https://api.tamio.com/v2/discounts/product-discount/create", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     // ... request body
9   })
10 });
11 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/discounts/product-discount/create")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Post.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 request["Content-Type"] = "application/json"
13 request.body = %Q{
14   // ... request body
15 }
16 
17 response = https.request(request)
18 puts response.read_body

Responses

{
  "status": 200,
  "discount": {
    "id": "string",
    "object": "discount",
    "label": "Summer Sale 10% Off",
    "currency": "EUR",
    "percent_off": 10,
    "amount_off": 0,
    "shipping_percent_off": 0,
    "shipping_amount_off": 0,
    "active": true,
    "type": "product_discount",
    "condition": "coupon",
    "applies_to": "all_products",
    "rule_amount": null,
    "order_condition": "order_subtotal",
    "block_affiliates": false,
    "destinations": [
      "worldwide"
    ],
    "payments": [
      "all"
    ],
    "expiry_date": 0,
    "subscription_discount_duration": "once",
    "number_of_months": 0,
    "domain": 0,
    "customer": "string",
    "products": [],
    "categories": {},
    "coupon": "SUMMER10",
    "coupon_max_redemptions": 100,
    "coupon_times_redeemed": 45,
    "vouchers": [],
    "voucher_method": "string",
    "voucher_prefix": "string",
    "number_of_vouchers": 0,
    "created_at": 1700000000
  }
}

1	const response = await fetch("https://api.tamio.com/v2/discounts/product-discount/create", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	// ... request body
9	})
10	});
11	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/discounts/product-discount/create")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Post.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12	request["Content-Type"] = "application/json"
13	request.body = %Q{
14	// ... request body
15	}
16
17	response = https.request(request)
18	puts response.read_body