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
For each trigger (see “When to send” for each data type), send the correct event with the following fields. There is no need to filter the data you send or check for duplicates. Amazon does this as necessary.

Watch activity

Field NameRequired (Y/N)Description
Event TypeYThe event can be either Active or Off-Device. See details.
Content IDYID of the content the customer is watching as specified through catalog integration.
Live Channel Station IDY*ID of the live linear channel playing the content as specified through catalog integration.
* Required for live content only.
Internal Profile IDYProvide an obfuscated Profile ID so Fire TV can associate the activity with the correct app customer.
DurationYLength of content in milliseconds.
Current Playback PositionYOffset from start of content in milliseconds, excluding interstitial content (previews, ads, etc.).
Credits PositionNPosition of the credits in the content. Offset from start of content in milliseconds, excluding interstitial content (previews, ads, etc.). This field will help Fire TV understand when a customer has finished watching the content.
Event TimestampN** This is required for Off-Device events, but not for Active events.
Playback StateYEnum with the following possible values: PLAYING, PAUSED, EXIT, or INTERSTITIAL.

Watchlist

Field NameRequired (Y/N)Description
Content IDYCorresponds to the content ID provided to Fire TV through the 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.

Next Steps

Take a look at another handy reference for triggers and SDK calls in the Summary Reference Table.
Last modified on July 14, 2026