Create a webhook subscription
Subscribe a public HTTPS URL to one or more platform events. Every requested event is delivered to the same URL and signed with the single signingSecret returned in the response — store it, as it is only returned at creation time. The token must hold the OAuth scope each requested event needs: read:creator for subscription.new, subscription.renewed, subscription.cancelled, subscription.expired, follow.new, purchase.new, tip.new, the checkout_link.* and payout.paid events, and the creator.payment.succeeded, creator.subscription.*, creator.refund.created, and creator.dispute.* events; read:post for creator.post.liked and creator.post.commented; read:chat for message.received, message.read, creator.message.received, creator.message.sent, creator.message.read, creator.message.reaction, and creator.message.deleted.
read:self— Access your own user profile information, including basic account details and settings.
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
Public HTTPS URL the event payloads are delivered to (no redirects, no localhost)
One or more platform events this subscription delivers
1The platform event the webhook subscription delivers
checkout_link.payment.pending, checkout_link.payment.succeeded, checkout_link.payment.failed, checkout_link.subscription.activated, checkout_link.subscription.deactivated, checkout_link.subscription.cancel_at_period_end_changed, checkout_link.refund.created, checkout_link.dispute.flagged, checkout_link.dispute.created, checkout_link.installment.paid, checkout_link.installment.failed, checkout_link.plan.completed, payout.paid, follow.new, message.read, message.received, purchase.new, subscription.new, subscription.renewed, subscription.cancelled, subscription.expired, tip.new, creator.payment.succeeded, creator.subscription.activated, creator.subscription.deactivated, creator.subscription.cancel_at_period_end_changed, creator.post.liked, creator.post.commented, creator.message.reaction, creator.message.deleted, creator.refund.created, creator.dispute.flagged, creator.dispute.created, creator.fan.status_changed, creator.follow.created, creator.message.received, creator.message.sent, creator.message.read