XF 2.3 User Upgrade and Webhooks

[BubbaLovesCheese]

Xenforo provides 6 webhooks for User Upgrade events:

• user_upgrade.insert
• user_upgrade.update
• user_upgrade.delete
• user_upgrade.purchase_complete
• user_upgrade.purchase_reinstate
• user_upgrade.purchase_reverse

Which one of these, if any, trigger when an user's subscription/membership expires?

Thanks!

 

[BuildBridges]

Bump.

 

[eDaddi]

... and what triggers them?

Cron jobs only?
Active upgrades only?
Manual upgrade/downgrades? (I can't seem to get these to fire)

 

[Kirby]

Which one of these, if any, trigger when an user's subscription/membership expires?

Most likely none if them, but I'd have to check the code to be 100% sure.

 

[Kirby]

... and what triggers them?

Insert/Delete/Update webhooks are triggered when the corresponding entity action happens.

Other webhooks are usually triggered when that specific action happens.

I haven't specifically checked the mentioned hooks yet, but you might want to look at https://xenforo.com/community/threads/many-webhook-actions-dont-seem-to-work.226533/

 

[eDaddi]

After a lot of testing ...

• These only fire when adding/editing/deleting User Upgrade Packages Themselves
  • user_upgrade.insert
  • user_upgrade.update
  • user_upgrade.delete
• These only happen when a payment gateway is involved
  • user_upgrade.purchase_complete
  • user_upgrade.purchase_reinstate
  • user_upgrade.purchase_reverse
• These NEVER trigger a webhook call
  • Manually Upgrading
  • Manually Downgrading (from manual upgrade OR a payment gateway upgrade)
  • Cron downgrades

Suggested addition to include manual upgrade/downgrades events in webhook calls:

Thread 'Webhooks - Manual User Upgrade & Downgrade'

Jan 4, 2026

Manual user upgrades/downgrades don’t currently fire the User Upgrades webhook which creates a critical automation gap.

Can we get event options for:

• Manual user upgrades
• Manual user downgrades
• Cron downgrades

• eDaddi
• Replies: 0
• Forum: XenForo suggestions