Create a promotion
Create a promotional subscription offer: either a first-month discount (discountPercent) or a free trial, never both. For a free trial, set freeTrialDays (1-30), or set freeTrial: true without freeTrialDays for an unlimited (free-forever) trial.
Creating a promotion replaces any existing promotion targeting the same audience group, and eligible fans are notified.
write:creator— Modify creator profiles, settings, and creator-specific data.
Authorizations
OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.
Headers
API version to use for the request
"2025-06-26"
Body
Which fans can redeem the promotion: new_subscribers (never subscribed), expired_subscribers, followers, or all
new_subscribers, expired_subscribers, all, followers First-month discount as a percentage of the subscription price. Mutually exclusive with a free trial.
1 <= x <= 100Set to true to offer a free trial. Combine with freeTrialDays for a fixed length, or omit freeTrialDays for an unlimited (free-forever) trial. Mutually exclusive with discountPercent. Passing freeTrialDays alone also implies a free trial.
Length of the free trial in days (1-30). Omit while freeTrial is true for an unlimited (free-forever) trial. Mutually exclusive with discountPercent.
1 <= x <= 30Maximum number of redemptions. Unlimited when omitted.
1 <= x <= 1000When the promotion stops being redeemable. Never expires when omitted.
Optional message shown to fans with the promotion
Response
Promotion created successfully
Promotion UUID
Whether the promotion is a first-month discount or a free trial
discount, free_trial Discount percentage (null for free-trial promotions)
Free trial length in days (null for discount promotions)
Which fans can redeem the promotion: new_subscribers (never subscribed), expired_subscribers, followers, or all
new_subscribers, expired_subscribers, all, followers When the promotion expires (null if it never expires)
Maximum number of redemptions (null if unlimited)
Number of times the promotion has been redeemed
Message shown to fans with the promotion
When the promotion was created