Subscriptions Plans
Attach Promotion to Plan
Attaches an existing promotion to a subscription plan for a number of charges, so the plan’s subscriptions can receive it
POST
Attach Promotion to Plan
Attaches an existing promotion to a plan. Subscriptions on the plan can then receive the promotion when they are created or updated. The attachment sets how many charges the discount covers (
cycles) and what a pause does to it (on_pause). See Promotions on subscription plans.
The response, and each item in the plan’s promotions list, shows the attachment’s promotion_id, name, type, status, cycles, on_pause and attached_at.
type is the promotion’s redemption mode: AUTOMATIC (applied by itself when a subscription is created on the plan) or CODE (applied only when the merchant sends its code).
Attachments are not editedTo change
cycles or on_pause, remove the attachment with Remove Promotion from Plan and attach the promotion again. Removing an attachment does not change the subscriptions that already have the promotion.Errors
See Subscription promotion error codes for every reason.
Authorizations
Headers
The account_id found in your Yuno Dashboard (UUID). Required — omitting it returns 400 BAD_REQUEST ("Invalid x-account-code header.").
Body
application/json
Response
- The promotion is attached to the plan.