App_subscription_* webhooks vs free plan in the app pricing

Hi there,

Recently we subscribed to the app life cycle events and I have a question regarding app_subscription_* webhooks.

Our app includes a free plan that applies if there’s no more than 3 users on the account. What will happen in the case described below?

  1. User (on a paid monday plan, 2 users) installs our app. A trial period starts now.
  2. We receive both - install and app_trial_subscription_started webhooks.
  3. Trial period of our app ends. We receive app_trial_subscription_ended webhook. User can still use our app on a free plan.

Important information: a change from trial to the free plan happens automatically - if the account fulfills the condition based on the number of seats they can still use the app, if condition is not met app prompts user to the upgrade.

Question: In that case, if subscription changes from a trial period of our app to the free plan, should we receive any of app_subscription_* webhook? If yes, which one will it be?

Hi @anowacka ,

Bill here from monday.com

You should only receive the app_trial_subscription_ended webhook when this happens.

Since the user doesn’t end up purchasing a subscription, their transition to the free plan won’t trigger a app_subscription_created or app_subscription_changed webhook.

After receiving the app_trial_subscription_ended webhook, you could always query the API to double check which plan they are currently on.

I hope this helps!

Cheers,
Bill

Thank you @Billchenau ! Another question if I may: if user is on a paid feature-based subscription and decides to go on a free plan, will we receive app_subscription_changed webhook? Or app_subscription_cancelled_by_user?

@anowacka you’re welcome!

Sorry for the delay in reply. In this case, you should receive a “app_subscription_changed” webhook since they are changing plans to the free tier.

If they were to cancel completely, then you’d receive a “app_subscription_cancelled_by_user” webhook.

Cheers,
Bill

1 Like