Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Develop
Test
Publish
Monetize
Engage users
Device specifications
Resources
Skip to main content
These instructions are for the addition and removal of content from the customer’s watchlist. Fire TV might use watchlist information to update the customer’s universal watchlist.

What to send

If the trigger is an app install and sign-in, provide all watchlist items with action=add. Otherwise, only send added and removed items. When triggered, send all the data. Amazon takes care of duplicates, so no need to filter these out yourself.
Field NameRequired (Y/N)Description
Content IDYCorresponds to the content ID provided to Fire TV through your catalog integration.
Activity DateYTimestamp of when the customer added or removed the entitlement.
List ActionYADDED or REMOVED.
Internal Profile IDYProvide an obfuscated Profile ID so that Fire TV can associate the activity with the correct app customer.

When to send

  • When app initially launches and the user signs in.
  • When adding or removing an item from the customer’s watchlist. This action can occur off-device.
  • When switching to a new profile.

How to send

To share the latest title the customer added to the watchlist, use the following code:

Send the customer’s full watchlist

The following example code shows how to send the customer’s full watchlist.

Next Steps

You can view the data types on the Data Type Reference.
Last modified on July 31, 2026