Skip to main content
POST
/
v1
/
discounts
Create a discount.
curl --request POST \
  --url https://api.creem.io/v1/discounts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "name": "Holiday Sale",
  "code": "HOLIDAY2024",
  "type": "percentage",
  "amount": 20,
  "currency": "USD",
  "percentage": 15,
  "expiry_date": "2024-12-31T23:59:59Z",
  "max_redemptions": 100,
  "duration": "repeating",
  "duration_in_months": 6,
  "applies_to_products": [
    "prod_123",
    "prod_456"
  ]
}'
{
  "id": "<string>",
  "mode": "test",
  "object": "discount",
  "status": "active",
  "name": "Holiday Sale",
  "code": "HOLIDAY2024",
  "type": "percentage",
  "amount": 20,
  "currency": "USD",
  "percentage": 15,
  "expiry_date": "2024-12-31T23:59:59Z",
  "max_redemptions": 100,
  "duration": "repeating",
  "duration_in_months": 6,
  "applies_to_products": [
    "prod_123",
    "prod_456"
  ]
}

Headers

​
x-api-key
string
required

Body

application/json
​
name
string
required

The name of the discount.

Example:

"Holiday Sale"

​
type
enum<string>
required

The type of the discount, either "percentage" or "fixed".

Available options:
percentage,
fixed
​
duration
enum<string>
required

The duration type for the discount.

Available options:
forever,
once,
repeating
Example:

"repeating"

​
applies_to_products
string[]
required

The list of product IDs to which this discount applies.

Example:
["prod_123", "prod_456"]
​
code
string

Optional discount code. If left empty, a code will be generated.

Example:

"HOLIDAY2024"

​
amount
number

The fixed value for the discount. Only applicable if the type is "fixed".

Example:

20

​
currency
string

The currency of the discount. Only required if type is "fixed".

Example:

"USD"

​
percentage
number

The percentage value for the discount. Only applicable if the type is "percentage".

Example:

15

​
expiry_date
string<date-time>

The expiry date of the discount.

Example:

"2024-12-31T23:59:59Z"

​
max_redemptions
number

The maximum number of redemptions for the discount.

Example:

100

​
duration_in_months
number

The number of months the discount is valid for. Only applicable if the duration is "repeating" and the product is a subscription.

Example:

6

Response

200 - application/json

Successfully created a discount

​
id
string
required

Unique identifier for the object.

​
mode
enum<string>
required

String representing the environment.

Available options:
test,
prod,
sandbox
​
object
string
required

A string representing the object’s type. Objects of the same type share the same value.

Example:

"discount"

​
status
enum<string>
required

The status of the discount (e.g., active, inactive).

Available options:
active,
draft,
expired,
scheduled
Example:

"active"

​
name
string
required

The name of the discount.

Example:

"Holiday Sale"

​
code
string
required

The discount code. A unique identifier for the discount.

Example:

"HOLIDAY2024"

​
type
enum<string>
required

The type of the discount, either "percentage" or "fixed".

Available options:
percentage,
fixed
Example:

"percentage"

​
amount
number

The amount of the discount. Can be a percentage or a fixed amount.

Example:

20

​
currency
string

The currency of the discount. Only required if type is "fixed".

Example:

"USD"

​
percentage
number

The percentage of the discount. Only applicable if type is "percentage".

Example:

15

​
expiry_date
string<date-time>

The expiry date of the discount.

Example:

"2024-12-31T23:59:59Z"

​
max_redemptions
number

The maximum number of redemptions allowed for the discount.

Example:

100

​
duration
enum<string>

The duration type for the discount.

Available options:
forever,
once,
repeating
Example:

"repeating"

​
duration_in_months
number

The number of months the discount is valid for. Only applicable if the duration is "repeating" and the product is a subscription.

Example:

6

​
applies_to_products
string[]

The list of product IDs to which this discount applies.

Example:
["prod_123", "prod_456"]
⌘I