Skip to main content

New `reason` field in subscription canceled webhooks

  • August 14, 2023
  • 5 replies
  • 451 views

rachelatmonday
Forum|alt.badge.img

When a user churns from monday.com, their app subscriptions are also canceled. Therefore, the app_subscription_cancelled webhook will now contain a reason field indicating their subscription was canceled upon renewal. Currently, this is the only instance when the reason field appears, though we plan on adding support for additional reasons in the future.

{
  "type":"app_subscription_cancelled",
  "data":{
    "app_id":1000000000,
    "user_id":1,
    "user_email":"user1@users.com",
    "user_name": "User 1",
    "user_cluster": 'other',
    "account_tier": 'free',
    "account_name": "Demo Account",
    "account_slug": "test",
    "account_max_users": 10000,
    "account_id":777777,
    "version_data":{
      "major":1,
      "minor":2,
      "patch":0,
      "type":"minor"
    },
    "timestamp":"2022-06-23T00:00:00.000+00:00",
    "subscription":{
      "plan_id":"plan1",
      "renewal_date":"2022-07-19T00:00:00+00:00",
      "is_trial":false,
      "billing_period":"monthly",
      "days_left":26,
      "pricing_version":5
    },
    "reason":"monday_subscription_cancel_on_renewal"
  }
}

5 replies

dvdsmpsn
Forum|alt.badge.img+1
  • Participating Frequently
  • August 14, 2023

Pleas document all valid values for this field and link to the documentation.

Thank you 🙇‍♂️


rachelatmonday
Forum|alt.badge.img
  • Author
  • monday.com Team Member
  • August 14, 2023

Hi @dvdsmpsn,

There’s only one valid value/instance (for now) for this field: “reason”:“monday_subscription_cancel_on_renewal”. You can find the field below the subscription information in the payload above, and it is documented here.

Let us know if you have any questions! 😃


dvdsmpsn
Forum|alt.badge.img+1
  • Participating Frequently
  • September 7, 2023

@rachelatmonday

Looking into this further, on the app_subscription_cancelled webhook I am not seeing any reason field being sent in the payload, ever.

For the app_subscription_cancelled_by_user webhook, I have twice seen reason being populated with text:

  1. monday_subscription_cancel_on_renewal
  2. Unable to pay

Normally, the reason field is just not sent at all.


rachelatmonday
Forum|alt.badge.img
  • Author
  • monday.com Team Member
  • September 7, 2023

Hi @dvdsmpsn,

I’m taking this with the team and will keep you updated. The field should only appear if a user cancels their monday.com subscription, so it is strange that you got the “Unable to pay” reason.

Regarding not receiving webhooks, are you aware of users who canceled monday.com (ultimately canceling their app subscription) for which you didn’t get a webhook?

Best,
Rachel


rachelatmonday
Forum|alt.badge.img
  • Author
  • monday.com Team Member
  • September 11, 2023

Hi again @dvdsmpsn,

Our billing team is looking into this and needs the account ID that you got the “Unable to pay” reason field for. Could you please send that to me as a message?

Best,
Rachel