PelcroSubscriptionCreate

Overview

Fired when a new subscription is successfully created. Use this event to track conversions and update UI after purchase.

Triggered By

Method	Description
`Pelcro.subscription.create()`	Creating a new subscription

Event Detail

The event.detail object contains the created subscription:

Property	Type	Description
`id`	number	Subscription ID
`status`	string	Subscription status
`plan`	object	The subscribed plan
`plan.id`	number	Plan ID
`plan.name`	string	Plan name
`plan.interval`	string	Billing interval
`current_period_start`	string	Current period start date
`current_period_end`	string	Current period end date
`cancel_at_period_end`	boolean	Whether subscription will cancel at period end

Example

document.addEventListener('PelcroSubscriptionCreate', (event) => {
  const subscription = event.detail;

  console.log(`New subscription: ${subscription.plan.name}`);

  // Track conversion in analytics
  analytics.track('Subscription Created', {
    subscriptionId: subscription.id,
    planId: subscription.plan.id,
    planName: subscription.plan.name,
    interval: subscription.plan.interval
  });

  // Show confirmation
  showSuccessMessage(`Welcome! You're now subscribed to ${subscription.plan.name}`);

  // Unlock premium content
  unlockPremiumContent();
});

Related Events

After a subscription is created, you may also see:

PelcroUserLoaded - User data refreshed with new subscription

Events Overview - All available events
PelcroSubscriptionCancel - Cancellation event
Subscription Module - Subscription methods