Skip to main content

Create Discount Code

POST 

/api/discount-codes

Create a new discount code.

Authentication: Requires Bearer token.

Fields:

  • code (required): Unique discount code string (max 255 chars)
  • description (optional): Description of the discount (max 500 chars)
  • type (required): Discount value type. One of: percentage, fixed_amount
  • rate (optional): Percentage rate (0–100). Used when type is 'percentage'
  • amount (optional): Fixed amount. Used when type is 'fixed_amount'
  • scope (required): What the discount applies to. One of: line, order, both
  • apply_before_tax (optional): Whether discount is applied before tax calculation
  • is_active (optional): Whether the code is active

Request

Responses

Successful response