Skip to main content
POST
/
admin
/
v1
/
subscriptions
/
{subscriptionId}
/
discounts
cURL
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<uuid>
required

The subscription identifier

Body

application/json
  • Option 1
  • Option 2
​
code
string
required

Discount code to apply

Response

200 - application/json

Default Response

​
id
string<uuid>
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
  • Option 1
  • Option 2
​
value
object
required
  • Option 1
  • Option 2
​
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