Subscription Promotions

Apply promotion to subscription

Applies a promotion to a subscription.

Important considerations:

  • Some promotions may have redemption limits per subscription
  • Some promotions may have duration limits
  • Signup promotions cannot be applied to an existing subscription
  • Trial promotions are tied to a single tier or add-on
post/subscriptions/{subscriptionId}/promotions/{id}

Request

  • Base URL
    https://api.smokeball.com
  • URL
    https://api.smokeball.com/subscriptions/{subscriptionId}/promotions/{id}
  • Auth
    API key in header x-api-key and API key in header Authorization

Path parameters

subscriptionIdstring required

The unique identifier of the subscription

idstring uuid required

The identifier of the promotion to apply

Response

When request is accepted. Returns a 'Link' object.

idstring nullable
hrefstring nullable
relationstring nullable
methodstring nullable

Changes

No recorded changes to this operation across all 15 revisions of this API.