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.created
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
Description: When a user account is deleted.
Trigger(s):
- A site administrator deletes a user’s account from the site.
customer.updated
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y* |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
Y |
Y |
Y |
Y |
Y |
N |
Y |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
Y |
Y |
Y |
Y |
Y |
Y |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
Y |
Y |
Y |
Y |
Y |
Y |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
Y |
Y |
Y |
Y |
Y |
Y |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
Description: A user’s subscription is paused.
Trigger(s):
- A user’s subscription has entered a paused state.
customer.product.resumed
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
Y |
Y |
Y |
Y |
Y |
Y |
Y |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
Y |
Y |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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
|
Web |
iOS |
tvOS |
Android |
Android TV |
Fire TV |
Roku |
API |
|
Y |
N |
N |
N |
N |
N |
N |
N |
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.