🔒
Requires write_price_rules access scope. More access scope

The Batch Create Discount Code API creates multiple discount codes associated with a specific price rule in a single API call. This bulk operation allows merchants to efficiently generate large numbers of discount codes for marketing campaigns, promotions, or special events.

This API is particularly useful for:

Generating hundreds or thousands of codes for large-scale promotions
Creating codes for segmented marketing campaigns (email lists, social media channels)
Setting up automated discount code generation for partner programs

Request Parameters

Public Request Parameters

📘
Public Request Parameters

Path Parameters

Parameter	Type	Required	Description	Example
`price_rule_id`	string	Yes	Price rule ID	`pr_123456`

Body Parameters

Parameter	Type	Required	Description	Example
`discount_codes`	object	Yes	The discount code configuration object	`{...}`
`discount_codes[].code`	string	Yes	The actual discount code text (must be unique)	`SUMMER20`
`discount_codes[].use_with_other`	int32	No	Whether the code can be used with other discounts (1=yes, 0=no)	`1`
`discount_codes[].usage_limit`	int32	No	Maximum number of times the code can be used	`100`

Response Explanation

Public Response Parameters

📘
Public Response Parameters

Successful Response

Parameter	Type	Example	Description
`code`	string	`200`	Error code (200 indicates success)
`message`	string	`Success`	Error message
`data`	object	`{...}`	Contains the price rules data
`data.discount_codes`	`array of objects`	`[ {...}, {...} ]`	List of discount code objects

Discount Code Object Structure

Parameter	Type	Example	Description
`id`	string	`dc_123456`	Unique identifier of the discount code
`price_rule_id`	string	`pr_123456`	ID of the associated price rule
`code`	string	`SUMMER20`	The actual discount code text
`created_at`	string	`2023-06-20T15:30:00Z`	Timestamp when the discount code was created
`updated_at`	string	`2023-06-21T09:15:00Z`	Timestamp when the discount code was last updated
`use_with_other`	int32	`1`	Whether the code can be used with other discounts (1=yes, 0=no)
`usage_count`	int32	`42`	Number of times the discount code has been used

Error Response

Field	Type	Example	Description
`code`	string	`InvalidParameter`	Error http message
`message`	string	``	Error message

API Structure Overview