For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
StatusSupportDiscussionsLog inSign Up
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
    • Docs Home
  • Getting started
    • Welcome to FastPix
    • Activate your account
    • Set up a workspace
    • Upload and play your first video
  • Webhooks
    • Set up webhooks
    • Webhook event reference
  • Language SDKs
    • Choose an SDK
    • Node.js SDK
    • Python SDK
    • Go SDK
    • Java SDK
    • PHP SDK
    • Ruby SDK
    • C# SDK
  • Integrations
    • Integrate FastPix with WordPress
    • Build a video sharing app with StreamGate
  • Account and billing
    • Manage usage and billing
    • Understand FastPix pricing
  • Changelog
    • Release notes
LogoLogo
StatusSupportDiscussionsLog inSign Up
On this page
  • Media related events
  • Transform media events
  • In-video AI events
  • Live stream related events
  • Simulcast target events
Webhooks

Webhook event reference

Learn about FastPix webhook events that notify your system about migration, processing, and media status changes, enabling real-time updates and seamless automation.

Was this page helpful?
Previous

Choose an SDK

Explore all FastPix Language SDKs, including Python, Node.js, PHP, Go, C#, Java, Ruby, Unity, and more, for rapid video integration.

Next
Built with
Media related events
Transform media events
In-video AI events
Live stream related events
Simulcast target events

Media related events

These events notify your system about the upload, creation, availability, or failure of media assets, such as videos or audio files. They also track when media assets are updated or deleted, allowing your system to respond accordingly.


Webhook eventDescriptionUse Case
video.media.createdTriggered when a new media has been successfully created (Pull from URL).Notify your system when media is available on the platform.
video.media.uploadIndicates that a direct upload has been initiated. The user or system requests an upload URL. (Push media)Useful for tracking when users start uploading media through your app.
video.upload.media_createdA media asset has been created from an upload. Triggered when an end user finishes uploading a file through a direct upload.Track when a media is successfully created after an upload.
video.media.readyTriggered when the media (video or audio) is ready for playback. Used for both Push and Pull.Use the playbackId to initiate streaming of the media.
video.media.failedTriggered when the media asset encounters an error during processing (e.g., invalid input URL).Notify your system about errors for debugging or user notifications.
video.media.deletedTriggered when a media asset has been deleted.Remove references to the media, as it is no longer available.
video.media.updatedTriggered when an existing media is updated.Sync your system to reflect any changes made to the media.
video.media.live_stream.createdTriggered when a live stream is recorded into an on-demand media. A manifest file is created and a playbackId is generated for streaming.Useful for handling live stream recordings and initiating on-demand playback.

Transform media events

These events notify your system when specific transformations, enhancements, or modifications to media assets have been successfully applied. Use these events to trigger downstream workflows like updating your UI, notifying users, or moving media to the next processing stage.


Webhook eventDescription
video.media.intro.readyTriggered when an intro clip has been successfully added to the beginning of the media asset.
video.media.outro.readyTriggered when an outro clip has been successfully added to the end of the media asset.
video.media.expunge.readyTriggered when specified segments of the media have been successfully removed. Useful for cutting out unwanted sections.
video.media.splicing.readyTriggered when multiple media segments have been successfully stitched together into a single file.
video.media.impose_tracks.readyTriggered when a secondary audio track (such as background music or narration) has been successfully imposed onto the media.
video.media.audio_swap.readyTriggered when the original audio track has been successfully replaced with a new one.
video.media.watermark.readyTriggered when watermarking has been successfully applied to the media for branding or content protection.
video.media.optimize_audio.readyTriggered when audio optimization—such as loudness normalization or noise reduction—has been completed.
video.media.mp4Support.readyTriggered when an MP4-compatible version of the media has been successfully generated for playback or device fallback.
video.media.subtitle.generated.readyTriggered when subtitles or captions have been automatically generated and are ready for use.
video.media.track.createdTriggered when a new track, such as an additional audio or subtitle track, has been added to the media asset.
video.media.track.readyTriggered when an added track (audio or subtitle) has been successfully processed and is ready for playback.
video.media.track.failedTriggered when a track (audio or subtitle) encounters an error during processing. Useful for debugging or alerting.

In-video AI events

These events notify your system when AI-powered tasks—such as chapter generation, content summarization, named entity recognition, or moderation checks - are completed for a media asset.


Event NameDescription
video.mediaAI.chapters.readyTriggered when chapters have been successfully generated for the media, including start times, titles, and summaries.
video.mediaAI.namedEntities.readyTriggered when named entities like people, organizations, or locations have been identified within the media.
video.mediaAI.summary.readyTriggered when a summary of the media has been generated, providing a brief overview of the content.
video.mediaAI.moderation.readyTriggered when moderation analysis is complete, with results for categories like violence, adult content, or offensive language.


Live stream related events

These events track the full lifecycle of live streams, including creation, connection, and when the stream goes live or becomes idle. Additionally, they monitor the recording process and provide updates when streams are updated, enabled, disabled, or deleted.


WebhookDescription
video.live_stream.createdA new live stream has been created. Broadcasters possessing a stream key can commence transmitting their encoder feed to this particular live stream.
video.live_stream.preparingStatus indicates that the live stream is being initialized and set up. During this phase, the system is validating inputs and allocating resources before going live.
video.live_stream.connectedThe live stream is in a “connected” status for video live streaming, confirming that an encoder has established a successful connection to it.
video.live_stream.recordingThe live stream’s video recording is now in progress.
video.live_stream.activeThe live stream is currently marked as “active,” signifying that it is presently “live” and actively broadcasting.
video.live_stream.disconnectedWhen the stream is stopped, causing the encoder to become disconnected.
video.live_stream.idleThe live stream enters an “idle” state as there is no ongoing streaming activity.
video.media.live_stream.createdThis event is triggered when a live stream gets recorded and a new media has been successfully created as video-on-demand. Use this to notify your system when media is available in the platform.
video.live_stream.updatedThe live stream has been either updated, or the stream key for this livestream has been reset.
video.live_stream.deletedThe live stream has been deleted.

Simulcast target events

Simulcast target events give real-time updates on the status of third-party endpoints used in live streaming. They help you track the creation and deletion of simulcast targets, allowing your system to reflect their current status accurately in the user interface.


WebhooksDescription
video.live_stream.simulcast_target.createdA new simulcast has been created for a live stream.
video.live_stream.simulcast_target.startingThe simulcast target is initializing and preparing to begin broadcasting.
video.live_stream.simulcast_target.broadcastingThe live stream is now actively being simulcast to the third-party platform or destination.
video.live_stream.simulcast_target.deletedWhen the simulcast of a live stream has been deleted.
video.live_stream.simulcast_target.updatedWhen the simulcast of a live stream has been updated.