POST
/
admin
/
v1
/
subscriptions
/
{subscriptionId}
/
discounts
curl --request POST \
  --url https://api.juo.io/admin/v1/subscriptions/{subscriptionId}/discounts \
  --header 'Content-Type: application/json' \
  --header 'X-Juo-Admin-Api-Key: <api-key>' \
  --data '{
  "code": "<string>"
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resource": "subscription-discount",
  "title": null,
  "target": {
    "type": "shipping"
  },
  "value": {
    "amount": 123,
    "type": "fixed-amount",
    "appliesOnEachItem": true
  },
  "recurringCycleLimit": null
}

Authorizations

​
X-Juo-Admin-Api-Key
string
header
required

Path Parameters

​
subscriptionId
string
required

The subscription identifier

Body

application/json
​
code
string
required

Discount code to apply

Response

200 - application/json
Default Response
​
id
string
required
​
resource
enum<string>
required
Available options:
subscription-discount
​
title
string | null
required

The title of the discount shown to customers, typically displayed as a discount code.

Minimum length: 1
​
target
object
required
​
value
object
required
​
recurringCycleLimit
integer | null
required

The number of billing cycles for which this discount will be applied. After the recurring cycle limit is met the discount will be removed from the subscription.

Required range: x >= 1