API center

The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.

Parameters

No path or query parameters.

Request body

budget_amount string

campaign_code string

campaign_name string

campaign_redemption_limit string

combinability string

coupon_code string

currency string

customer_segments array

discount_type string

discount_value string

duration_cycles integer · int32

duration_type string

eligible_offer_ids array

expires_at string

first_purchase_only boolean

max_redemptions integer · int32

maximum_discount string

minimum_subtotal string

per_customer_limit integer · int32

curl --request POST 'https://nexus-api.rainlib.com/v1/promotions/coupons' \
  --header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
  --header 'Content-Type: application/json' \
  --data '{
  "budget_amount": "<value>",
  "campaign_code": "<value>",
  "campaign_name": "<value>",
  "campaign_redemption_limit": "<value>",
  "combinability": "<value>",
  "coupon_code": "<value>",
  "currency": "<value>",
  "customer_segments": [
    "<value>"
  ],
  "discount_type": "<value>",
  "discount_value": "<value>",
  "duration_cycles": 0,
  "duration_type": "<value>",
  "eligible_offer_ids": [
    "<value>"
  ],
  "expires_at": "<value>",
  "first_purchase_only": false,
  "max_redemptions": 0,
  "maximum_discount": "<value>",
  "minimum_subtotal": "<value>",
  "per_customer_limit": 0
}'

Response contract

Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.