Easily Integrate Freemius Webhooks with your application.

https://freemius.com/help/documentation/marketing-automation/events-webhooks/

Steps to receive Freemius Webhooks

Sign up for your free Hooky account.
Create a new Webhook Source, and select Freemius. This will be the endpoint that receives webhooks on behalf of your application, and forwards them using the unified SDK.
Step 1
Step 2
Once a webhook is received from Freemius, you'll see it under the Live Logs section of your webhook source.
Next, follow the examples below to integrate the Hooky SDK in ruby or javascript, and start receiving webhooks.

Save countless hours integrating Freemius webhooks into your application.

Integrating Freemius Webhooks Using Javascript

Integrating Freemius webhooks with Hooky in your Javascript based application is straight forward. Just grab the SDK, and call a function when that webhook is received.

Integrating Freemius Webhooks Using Ruby

Integrating Freemius webhooks with Hooky in your Ruby or Ruby on Rails application is straight forward. Just grab the SDK, and call a method when that webhook is received.

Configuring Freemius Webhook Authentication

Here's how it works

Supported Freemius Webhook Events

addon.free.downloaded

Occurs whenever a free version of an add-on is downloaded.

addon.premium.downloaded

Occurs whenever a premium version of an add-on is downloaded.

affiliate.approved

Occurs whenever an affiliate is approved.

affiliate.blocked

Occurs whenever an affiliate is blocked.

affiliate.created

Occurs whenever an affiliate is created.

affiliate.deleted

Occurs whenever an affiliate is deleted.

affiliate.paypal.updated

Occurs whenever there’s an update of an affiliates PayPal details.

affiliate.rejected

Occurs whenever an affiliate is rejected.

affiliate.suspended

Occurs whenever an affiliate is suspended.

affiliate.unapproved

Occurs whenever an affiliate state is changed from `approved` to `pending`.

affiliate.updated

Occurs whenever there’s an update of an affiliate details.

card.created

Occurs whenever a new card is added to a user’s dashboard account.

card.updated

Occurs whenever a user’s card details have been updated.

cart.abandoned

Occurs whenever a cart session has been abandoned.

cart.completed

Occurs whenever a ‘sale’ has been completed, but the payment hasn’t necessarily been completed yet (e.g. for trials, 100% coupon codes, or for PayPal subscription which takes 24 to process).

cart.created

Occurs whenever a cart session has been initiated.

cart.recovered

Occurs whenever an abandoned cart session has been recovered and converted into a ‘sale’ (i.e. triggers the cart.completed event).

cart.recovery.deactivated

Occurs when the cart recovery feature has been deactivated in the Developer Dashboard.

cart.recovery.email_1_sent

Occurs when the first cart recovery email has been sent.

cart.recovery.email_2_sent

Occurs when the second cart recovery email has been sent.

cart.recovery.email_3_sent

Occurs when the third (and final) cart recovery email has been sent.

cart.recovery.reactivated

Occurs when the cart recovery feature has been reactivated in the Developer Dashboard.

Occurs when the prospect re-subscribes to the cart abandonment recovery campaign through a link in the cart recovery emails. Or, if a developer of the product reactivates a recovery campaign through the Developer Dashboard.

cart.recovery.unsubscribed

Occurs when the prospect unsubscribes from the cart abandonment recovery campaign through a link in the cart recovery emails. Or, if a developer of the product stops a recovery campaign through the Developer Dashboard.

cart.updated

Occurs when the cart contents have been updated.

coupon.created

Occurs whenever a coupon is created.

coupon.deleted

Occurs whenever a coupon is deleted.

coupon.updated

Occurs whenever a coupon is updated.

developer.billing.updated

Occurs whenever the billing information of the developer is updated.

developer.secret_key.updated

Occurs when the developer secret key has been updated in the Developer Dashboard.

email.clicked

Occurs when a link is clicked by a user. Email link click tracking is only included in cart abandonment recovery and trial-related emails.

email.opened

Occurs when an email has been opened by a user. Email open tracking is only included in cart abandonment recovery, trial-related, and subscription renewal reminder emails.

install.activated

Occurs whenever a user is opted-in, and after reactivation of a product.

install.charset.updated

Occurs whenever an installation charset is updated.

install.connected

Occurs whenever a user opt-in after opting out from usage tracking.

install.deactivated

Occurs whenever the plugin is deactivated.

install.deleted

Occurs whenever a user delete the installation account.

install.disconnected

Occurs whenever a user that opted-in manually opt-out from usage tracking.

install.installed

Occurs whenever a user is opted-in (triggered before install.activated).

install.language.updated

Occurs whenever an installation language is updated.

install.ownership.candidate.confirmed

Occurs whenever an account ownership transfer candidate confirms the transfer.

install.ownership.completed

Occurs whenever an account ownership transfer is complete.

install.ownership.initiated

Occurs whenever an account ownership transfer is initiated.

install.ownership.owner.confirmed

Occurs whenever an account ownership transfer is confirmed by the current installation account owner.

install.plan.changed

Occurs whenever an installation plan is changed.

install.plan.downgraded

Occurs whenever an installation plan is downgraded to the default plan (if the default plan is free, then when downgraded back to the free version).

install.platform.version.updated

Occurs whenever an installation WordPress version is updated.

install.premium.activated

Occurs whenever the premium code version of the plugin is activated.

install.premium.deactivated

Occurs whenever the premium code version of the plugin is deactivated.

install.programming_language.version.updated

Occurs whenever an installation PHP version is updated.

install.sdk.version.updated

Occurs whenever an installation Freemius WordPress SDK version is updated.

install.title.updated

Occurs whenever an installation’s site title is updated.

install.trial.cancelled

Occurs when a trial is cancelled.

install.trial.expired

Occurs when a trial is expired.

install.trial_expiring_notice.sent

Occurs when an email has been sent to the user notifying them the trial period is about to end.

install.trial.extended

Occurs whenever a trial is manually extended.

install.trial.plan.updated

Occurs whenever a trial plan is updated.

install.trial.started

Occurs when a free trial is started on an existing product install.

install.uninstalled

Occurs whenever the plugin/theme is uninstalled.

install.updated

Occurs whenever an installation data is updated (in addition to specific install update events).

install.url.updated

Occurs whenever an installation’s home URL is updated.

install.version.downgrade

Occurs whenever the plugin/theme is downgraded to a lower version (not related to the plan).

install.version.upgraded

Occurs whenever the plugin/theme is upgrade to a newer version (not related to the plan).

license.activated

Occurs whenever a license is activated (also triggered automatically after a successful plan upgrade).

license.blacklisted_site.deleted

Occurs when a blacklisted site has been removed in the User Dashboard.

license.cancelled

Occurs when a license is cancelled.

license.created

Occurs whenever a license is created.

license.deactivated

Occurs whenever a license is deactivated.

license.deleted

Occurs when a license has been deleted in the Developer Dashboard.

license.expired

Occurs when a license expires.

license.expired_notice.sent

Occurs when a license expired email notice has been sent to the user.

license.extended

Occurs whenever a license is extended by the developer from the dashboard.

license.ownership.changed

Occurs whenever a license ownership is changed by the developer from the dashboard.

license.quota.changed

Occurs whenever a license quota is changed by the developer from the dashboard.

license.renewal_reminder.sent

Occurs when a license renewal reminder email has been sent to the user.

license.shortened

Occurs when a license has been shortened in the User/Developer Dashboard.

license.site.blacklisted

Occurs when a site has been blacklisted in the User Dashboard.

license.site.whitelisted

Occurs when a site has been whitelisted in the User Dashboard.

license.trial_expiring_notice.sent

Occurs when a courtesy trial expiration reminder email has been sent to the user. For 7-day trials, the email is sent 2 days prior to the trial expiration. For longer trials, the email is sent 7 days prior to the trial expiration.

license.updated

Occurs whenever a license is updated (in addition to specific license update events).

license.whitelisted_site.deleted

Occurs when a whitelisted site has been removed in the User Dashboard.

member.created

Occurs whenever a developer is added as a team member.

member.deleted

Occurs whenever a member is removed from a team.

member.updated

Occurs whenever a team member role is updated.

payment.created

Occurs whenever a successful payment is created. There’s no dedicated event for subscription renewals. To trigger an action only for renewals, your webhook needs to check the is_renewal flag of the event’s payment object provided with the event’s metadata.

payment.refund

Occurs whenever a payment refund is processed.

payment.dispute.created

Occurs whenever we notified about a payment disputed by a customer.

payment.dispute.closed

Occurs whenever a payment dispute is closed by refunding the disputed payment.

payment.dispute.lost

Occurs whenever a payment dispute is closed in favor of the customer.

payment.dispute.won

Occurs whenever a payment dispute is closed in your/seller’s favor.

plan.created

Occurs whenever a plan is created.

plan.deleted

Occurs whenever a plan is deleted.

plan.lifetime.purchase

Occurs whenever a user purchases a lifetime package (doesn’t matter which plan).

plan.updated

Occurs whenever a plan details are updated.

plugin.addresses.updated

Occurs whenever email addresses are updated.

plugin.created

Occurs whenever a plugin/theme is created.

plugin.deleted

Occurs when a plugin has been deleted in the Developer Dashboard.

plugin.feature.created

Occurs whenever a plan feature is created.

plugin.free.downloaded

Occurs whenever a free plugin/theme code version is downloaded.

plugin.premium.downloaded

Occurs whenever a premium plugin/theme code version is downloaded.

plugin.updated

Occurs when a plugin has been updated in the Developer Dashboard.

plugin.version.deleted

Occurs whenever a deployed version is deleted.

plugin.version.deployed

Occurs whenever a new plugin/theme version is deployed to Freemius.

plugin.version.released

Occurs whenever a version is set as released.

plugin.version.beta.released

Occurs whenever a version is released as beta.

plugin.version.release.suspended

Occurs whenever a deployment release is suspended.

plugin.version.updated

Occurs whenever an existing version is re-deployed to Freemius.

pricing.created

Occurs whenever a new pricing is added to a plan.

pricing.deleted

Occurs whenever one of the plan pricing is deleted.

pricing.updated

Occurs whenever a plan pricing is updated.

pricing.visit

Occurs when a user has visited the pricing table via the WordPress admin or popup checkout modal.

review.created

Occurs when a new plugin or theme review has been created.

review.deleted

Occurs when a review has been deleted in the Developer Dashboard.

review.requested

Occurs when a new review request email has been sent to the user. This is sent 7 days after purchase to users that haven’t canceled the license yet, were not refunded, and are using the product on at least one website.

review.updated

Occurs when a new review has been updated in the Developer Dashboard.

store.created

Occurs when a new store has been created (e.g. when a new Freemius account has been created).

store.dashboard_url.updated

Occurs when the store’s dashboard URL is updated.

store.plugin.added

Occurs when a product is added to a store.

store.plugin.removed

Occurs when a product is removed from a store.

store.url.updated

Occurs when a store’s URL is updated

subscription.cancelled

Occurs whenever a subscription is cancelled.

subscription.created

Occurs whenever a subscription is created.

subscription.renewal_reminder.sent

Occurs whenever an annual renewal reminder email is sent (30 days before the automatic renewal).

subscription.renewal_reminder.opened

Occurs whenever an annual renewal reminder email is opened.

subscription.renewal.failed

Occurs whenever a renewal payment processing is failed .

subscription.renewal.failed.last

Occurs when the latest subscription renewal attempt has failed.

subscription.renewal.failed_email.sent

Occurs whenever a failure renewal processing email is sent to the buyer.

subscription.renewal.retry

Occurs whenever a renewal payment retry is processed.

subscription.renewals.discounted

Occurs whenever a special subscription cancellation promo is applied.

user.beta_program.opted_in

Occurs when a user has opted into a plugin or theme beta program.

user.beta_program.opted_out

Occurs when a user has opted out of a plugin or theme beta program.

user.billing.updated

Occurs whenever a customer billing information is updated (e.g. address, VAT ID, company name).

user.card.created

Occurs whenever a new card is added to a user’s dashboard account. This is similar to card.created but also logs the connection between a user and a credit card. Different users in the system can be associated with the same credit card (e.g. if a company with multiple people is using the same credit card for all their purchases).