latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Update subscription price

Set the authenticated creator's monthly subscription price, in USD cents (minor units).

⚠️ Side effect when increasing the price: all existing active subscribers are moved to a pending opt-in state for the new price. With forceOptIn: false (default) they keep auto-renewing at their current price until they accept the new one; with forceOptIn: true they are forced to opt in at the new price and their current auto-renewal is disabled. The response's subscribersMovedToReOptIn reports whether this happened. Decreasing the price has no effect on existing subscribers.

The new price must stay compatible with the creator's promotions: if any promotion's discount would take it below the platform minimum, the request is rejected until that promotion is deleted.

patch/users/me/subscription-price

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Request body

subscriptionPriceinteger required

New monthly subscription price in USD cents (minor units), between 399 and 10000

forceOptInboolean

Only used when the price increases. When false (default), existing subscribers keep auto-renewing at their current price until they opt in to the new one. When true, they are forced to opt in at the new price and their current auto-renewal is disabled.

Response

Subscription price updated successfully

subscriptionPriceinteger required

The subscription price now in effect, in USD cents (minor units)

subscribersMovedToReOptInboolean required

True when the price increase moved existing active subscribers to a pending re-opt-in state (see the endpoint description)