Supported webhook topics and what they indicate on Vimeo OTT

Vimeo OTT allows you to use webhooks to be notified when an event has occurred in the lifecycle of any of your customers. You can find how to create webhooks in this guide. Below is a reference for all the webhook topics Vimeo OTT supports, including which platforms support them, a description, and what user action triggers them.

In this article:

•  customer.created 
• customer.deleted 
•  customer.updated 
• customer.product.created
• customer.tvod.created 
• customer.product.free_trial_created 
• customer.product.free_trial_converted 
• customer.product.free_trial_expired
• customer.product.renewed
• customer.product.updated
• customer.product.set_paused
• customer.product.undo_set_paused
• customer.product.paused
• customer.product.resumed
• customer.product.set_cancellation
• customer.product.undo_set_cancellation
• customer.product. cancelled
• customer.product.expired
• customer.product.disabled
• customer.product.charge_failed
• customer.product.set_change
• customer.product.undo_set_change
• customer.product.changed
• customer.tvod.accessed
• customer.tvod.expired

customer.created

Description: When a user account is created.

Trigger(s):

• A user registers for the site through the checkout flow.
• A user signs up for the site’s mailing list on the web (note: The properties “registered to site” and “subscribed to site” in this case will be set to False).
• A user without an account is presented a Geoblock message on the web, and submits their email address requesting access to the content (note: The properties “registered to site” and “subscribed to site” in this case will be set to False).
• A site administrator creates a user account for the site.
• A user signs up for the site's free registration product.

customer.deleted

Description: When a user account is deleted.

Trigger(s):

• A site administrator deletes a user’s account from the site.

customer.updated

Description: When a field in a user’s profile is updated.

Trigger(s):

• A user updates their name, email, or marketing email preference.
• A site administrator updates a user’s name, email, or marketing email preference.

customer.product.created

Description: When a user is added to a subscription product.

Trigger(s):

• A user purchases a subscription product and begins their free trial.
• A user purchases a subscription product without a free trial, and their card is billed immediately.
• A site administrator adds a user to a subscription product.

*This webhook does not fire on the Web platform after a user signs up for a free trial. In order to track free trial starts on the Web platform, use the "customer.product.free_trial_created" webhook instead. If you do not offer a free trial, you can continue to use this webhook to track users who purchase a subscription.

customer.tvod.created

Description: When a user purchases or rents a TVOD product.

Trigger(s):

• A user purchases or rents a TVOD product on the web or App Platform (Note: TVOD In-App Purchases are not supported on Roku)

customer.product.free_trial_created

Description: When a user is added to a subscription product and begins their free trial.

Trigger(s):

• A user purchases a subscription product with a free trial and starts the free trial period.

customer.product.free_trial_converted

Description: When a user’s free trial period ends, they are charged for the first time for their subscription.

Trigger(s):

• A user’s subscription status has shifted from a free trial to paid, and the user is charged for the first time.

customer.product.free_trial_expired

Description: When a user terminates their free trial and does not convert to a paying subscriber.

Trigger(s):

• A user has terminated their subscription during the free trial period.

customer.product.renewed

Description: A user’s subscription has been renewed.

Trigger(s):

• A user’s subscription renews. Use the "last_payment_date" and "next_payment_date" fields in the webhook response to check if a payment occurred. Note that for app users on annual subscriptions, this webhook triggers monthly.

customer.product.updated

Description: A user’s subscription duration has been updated.

Trigger(s):

• A user changes the duration of their subscription from monthly to annual, or from annual to monthly.

customer.product.set_paused

Description: A user initiates a pause of their subscription that goes into effect at the end of the current billing cycle.

Trigger(s):

• A user has set their subscription to be paused.

customer.product.undo_set_paused

Description: A user undoes their intention to set their subscription to a paused state.

Trigger(s):

• A user reactivates their subscription that was set to be paused. This is done before their subscription enters a paused state.

customer.product.paused

Description: A user’s subscription is paused.

Trigger(s):

• A user’s subscription has entered a paused state.

customer.product.resumed

Description: A user who has a paused subscription restarts their subscription.

Trigger(s):

• A user who had a subscription in a paused state restarts their subscription and is charged.

customer.product.set_cancellation

Description: A user initiates the cancellation of their subscription, which goes into effect at the end of the current billing cycle.

Trigger(s):

• A user has set their paid subscription to be cancelled.

⚠️Note: This webhook does not fire if the user is in a free trial. 

customer.product.undo_set_cancellation

Description: A user undoes their intention to set their subscription to a cancelled state.

Trigger(s):

• A user reactivates their subscription that was set to be cancelled. This is done before their subscription is cancelled.

customer.product.cancelled

Description: A user’s subscription is cancelled.

Trigger(s):

• A user’s subscription has expired and is no longer active because the user canceled the subscription.

customer.product.expired

Description: A user’s subscription has expired due to them not renewing their subscription or having a billing issue. The user can no longer access their subscription content.

Trigger(s):

• On the Web, after multiple failed attempts to charge the customer's card, we determined that they should no longer have access.
• On Apps (IAP), the user cancelled their subscription, and they should no longer have access.
• The user had temporary free access to a subscription, which ended.

customer.product.disabled

Description: A user's subscription is disabled, and they can no longer access their subscription.

Trigger(s):

• On the Web, the user was disabled by a system administrator.
• On Apps (IAP), we could not determine whether the user should continue to have access (due to an IAP billing or subscription-related issue), so we disabled their subscription.

customer.product.charge_failed

Description: A user's credit card failed to be charged.

Trigger(s):

• An error occurred when attempting to charge an existing subscriber's credit card. The charge failed.

customer.product.set_change

Description: A user sets a change between subscription products. This may be a change that will be processed soon after the request, such as going from a basic subscription to a premium subscription or a request processed at the end of the current billing cycle, such as a downgrade from a premium to a basic subscription.

Trigger(s):

• When a user changes their subscription product, but the change has not yet occurred.

customer.product.undo_set_change

Description: A user undoes a previously set change between subscription products.

Trigger(s):

• When a user undoes a previously set change to their subscription product that had not yet occurred.

customer.product.changed

Description: When a previously scheduled product change has been successfully processed.

Trigger(s):

• When a user undoes a previously set change to their subscription product that had not yet occurred.

customer.tvod.accessed

customer.tvod.expired