Live events


video.live_stream.created

Triggered when a new live stream is provisioned on the platform. This means your application has successfully created a stream resource, and a streamKey is now available for broadcasters to start pushing live video using an encoder.


NameTypeDescription
typestringType for the webhook event
webhookIdstringUnique identifier for the webhook
objectobject
- object.namestringType of webhook (e.g., live)
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
Workspaceobject
- Workspace.namestringName for the environment (e.g., production)
- Workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
dataobject
- data.testbooleanIndicates if the stream is a test stream. Test streams last five minutes and are removed after a day.
- data.streamIdstringUnique identifier for the stream. Max 255 characters (e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.statusstringCurrent live stream status: "idle" (no broadcast), disabled (no RTMP streams), active (broadcast in progress).
- data.audioOnlybooleanIf set to false, the stream processes only the audio track.
- data.streamKeystringUnique key used for streaming to a Fastpix RTMP endpoint; treat it as sensitive as credentials.
- data.srtSecertstringUnique key used for streaming to a FastPix endpoint; treat it as sensitive as credentials.
- dataTrailbooleanChecking the trails for streaming enabled or not (eg: true/ false)
- data.maxResolutionstringMaximum resolution for the live broadcast (e.g., 1080p).
- data.enableRecordingbooleanChecking the recording is enabled or not (Eg: true/ false).
- data.mediapolicystringAccess policy for the data (eg: public, private ..).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {key1:value1}).
- data.createdAtstringTimestamp for when the stream was created (e.g., 2023-12-06T09:12:28.808Z).
- data.reconnectWindowintegerTime (in seconds) Fastpix will wait before declaring the stream over after disconnection. Default is 60 seconds for Standard Latency.
- data.maxDurationintegerDuration (in seconds) that a live stream can last before disconnecting (e.g., 500).
- data.lowLatencybooleanData with lowLatency is enabled for stream (eg: true/false).
- data.playback_idsobject
-- data.playback_ids.idstringUnique identifier for the PlaybackID (e.g., public).
-- data.playback_ids[].accessPolicystringAccess policy for playback IDs; can be public or private.
- data.srtPlaybackResponseobject
- data.srtPlaybackResponse.srtPlaybackStreamIdstringUnique identifier id for the stream with initial play and max of 255 characters (eg: playf21f7c0b45108a04f051692e83af2943)
- data.srtPlaybackResponse.srtPlaybackSecertstringUnique identifier key for the stream, max of 255 characters.
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.connected

Fired when an encoder successfully connects to the live stream. The system confirms that it is now receiving an input feed, although the stream isn’t yet publicly live. This is useful for monitoring when the encoder handshake is complete.


NameTypeDescription
typestringType of event (e.g., video.media.intro.ready)
idstringUnique identifier for the event
workspaceobjectWorkspace information
- workspace.namestringName of the workspace (e.g., Development)
- workspace.idstringUnique identifier for the workspace
statusstringStatus of the media (e.g., ready)
dataobjectMedia-specific data
- data.thumbnailstring (URL)URL for the thumbnail image
- data.idstringUnique identifier for the media
- data.workspaceIdstringUnique identifier for the workspace
- data.metadataobjectMetadata associated with the media
-- data.metadata.key1stringKey-value pair for metadata (e.g., key1: value1)
- data.maxResolutionstringMaximum resolution for encoding/streaming
- data.sourceResolutionstringSource resolution of the media
- data.playbackIdsarrayList of playback IDs
-- data.playbackIds[].idstringUnique identifier for the playback ID
-- data.playbackIds[].accessPolicystringAccess policy (e.g., public)
-- data.playbackIds[].accessRestrictionsobjectAccess restrictions
--- domains.defaultPolicystringDefault policy for domains (e.g., allow)
--- domains.allowarrayList of allowed domains
--- domains.denyarrayList of denied domains
--- userAgents.defaultPolicystringDefault policy for user agents (e.g., allow)
--- userAgents.allowarrayList of allowed user agents
--- userAgents.denyarrayList of denied user agents
- data.tracksarrayList of tracks in the media
-- data.tracks[].idstringUnique identifier for the track
-- data.tracks[].typestringType of the track (e.g., video or audio)
-- data.tracks[].statusstringStatus of the track (e.g., available)
-- data.tracks[].languageCodestringLanguage code (if applicable)
-- data.tracks[].languageNamestringLanguage name (if applicable)
-- data.tracks[].widthintegerWidth of the video track (e.g., 1920)
-- data.tracks[].heightintegerHeight of the video track (e.g., 1080)
-- data.tracks[].frameRatestringFrame rate of the video track (e.g., 30/1)
- data.sourceAccessbooleanIndicates if source access is enabled
- data.mp4SupportstringIndicates MP4 support (e.g., none)
- data.optimizeAudiobooleanWhether audio optimization is enabled
- data.durationstringDuration of the media (e.g., 00:00:20)
- data.frameRatestringFrame rate of the media (e.g., 30/1)
- data.aspectRatiostringAspect ratio of the media (e.g., 16:9)
- data.createdAtstring (ISO 8601)When the media was created
- data.updatedAtstring (ISO 8601)When the media was last updated
createdAtstring (ISO 8601)When the event was created
attemptsarrayDelivery attempts
- attempts[].webhookIdstringWebhook attempt ID
- attempts[].responseStatusCodeintegerHTTP status code of the response
- attempts[].responseHeadersobjectResponse headers
-- contentTypestringe.g., application/json
-- transfer(optional)
-- serverstringServer used (e.g., nginx)
-- datestringDate of the response
-- cacheControl(optional)
- attempts[].responseBodystringBody of the response
- attempts[].maxAttemptsintegerMaximum number of retry attempts
- attempts[].idstringUnique identifier for the attempt
- attempts[].createdAtstring (ISO 8601)Timestamp of the attempt
- attempts[].addressstringWebhook target URL

video.live_stream.recording

Triggered when the platform starts recording the live stream. This allows the live session to be preserved for playback later as on-demand content. Use this event to update your system UI to show that recording is in progress.


NameTypeDescription
typestringType for the webhook event
webhookIdstringUnique identifier for the webhook
objectobject
- object.namestringType of webhook (e.g., live)
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
workspaceobject
- workspace.namestringName for the environment (e.g., production)
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
dataobject
- data.testbooleanIndicates if the stream is a test stream; lasts five minutes and is removed after a day.
- data.streamIdstringUnique identifier for the stream (e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218)
- data.statusstringCurrent live stream status: idle, disabled, or active.
- data.audioOnlybooleanIf set to false, the stream processes only the audio track.
- data.streamKeystringUnique key for streaming to a Fastpix RTMP endpoint; treat as sensitive.
- data.maxResolutionstringMaximum resolution for the live broadcast (e.g., 1080p).
- data.createdAtstringTimestamp for when the stream was created (e.g., 2023-12-06T09:12:28.808Z).
- data.reconnectWindowintegerTime (in seconds) to wait before considering stream ended after disconnection.
- data.maxDurationintegerMax duration (in seconds) a live stream can last (e.g., 500).
- data.srtSecertstringKey used for streaming to a FastPix endpoint; treat as sensitive.
- dataTrailbooleanWhether streaming trails are enabled (e.g., true/false).
- data.enableRecordingbooleanWhether recording is enabled (e.g., true/false).
- data.mediapolicystringAccess policy for the data (e.g., public, private).
- data.metadataobjectUser-supplied metadata (e.g., {key1:value1}).
- data.lowLatencybooleanWhether low latency mode is enabled (e.g., true/false).
- data.playback_idsobject
-- data.playback_ids.idstringUnique ID for the Playback ID (e.g., public).
-- data.playback_ids[].accessPolicystringAccess policy: public or private.
- data.srtPlaybackResponseobject
-- data.srtPlaybackResponse.srtPlaybackStreamIdstringUnique stream ID for playback (max 255 chars).
-- data.srtPlaybackResponse.srtPlaybackSecertstringUnique key for playback stream (max 255 chars).
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of delivery attempts.

video.live_stream.active

Indicates that the live stream is officially live and being broadcast to viewers. This is the moment when your audience can start watching the stream in real-time. You can use this webhook to trigger "Go Live" notifications or UI changes.


NameTypeDescription
typestringType for the webhook event
webhookIdstringUnique identifier for the webhook
objectobject
- object.namestringType of webhook (e.g., live)
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
workspaceobject
- workspace.namestringName for the environment (e.g., production)
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
dataobject
- data.testbooleanIndicates if the stream is a test stream (duration of five minutes; recorded asset removed after a day).
- data.idstringUnique identifier for the stream (max 255 characters).
- data.statusstringCurrent live stream status: idle, disabled, or active.
- data.audioOnlybooleanIf set to false, the stream processes only the audio track.
- data.streamKeystringUnique key for streaming to a Fastpix RTMP endpoint; treat as sensitive as credentials.
- data.maxResolutionstringMaximum resolution for the live broadcast (e.g., 1080p).
- data.createdAtstringTimestamp for when the stream was created (e.g., 2023-12-06T09:12:28.808Z).
- data.reconnectWindowintegerTime (in seconds) Fastpix will wait before declaring the stream over after disconnection; defaults to 60 seconds for Standard Latency streams.
- data.maxDurationintegerDuration (in seconds) that a live stream can last before disconnecting (e.g., 500).
- data.srtSecertstringUnique key used for streaming to a FastPix endpoint; treat it as sensitive as credentials.
- dataTrailbooleanIndicates if trails for streaming are enabled (e.g., true/false).
- data.enableRecordingbooleanIndicates if recording is enabled (e.g., true/false).
- data.mediapolicystringAccess policy for the data (e.g., public, private).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {key1:value1}).
- data.lowLatencybooleanIndicates if low latency is enabled for the stream (e.g., true/false).
- data.playback_idsobject
-- data.playback_ids.idstringUnique identifier for the PlaybackID (e.g., public).
-- data.playback_ids[].accessPolicystringAccess policy for playback IDs; possible values: public, private.
- data.srtPlaybackresponseobject
-- data.srtPlaybackResponse.srtPlaybackStreamIdstringUnique stream ID with initial play (max 255 characters; e.g., playf21f7c0b45108a04f051692e83af2943).
-- data.srtPlaybackResponse.srtPlaybackSecertstringUnique stream key (max 255 characters).
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.disconnected

Fired when the connection between the encoder and the platform is interrupted — for example, if the broadcaster stops their stream or there’s a network issue. This event signals a dropped stream and can be used to prompt reconnection flows.


NameTypeDescription
typestringType for the webhook event
webhookIdstringUnique identifier for the webhook
objectobject
- object.namestringType of webhook (e.g., live)
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
workspaceobject
- workspace.namestringName for the environment (e.g., "production")
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
dataobject
- data.testbooleanIndicates if the stream is a test stream (duration of five minutes; recorded asset removed after a day).
- data.idstringUnique identifier for the stream (max 255 characters).
- data.statusstringCurrent live stream status: idle (no broadcast), disabled (no more RTMP streams), active (broadcast in progress).
- data.audioOnlybooleanIf set to false, the stream processes only the audio track.
- data.streamKeystringUnique key for streaming to a Fastpix RTMP endpoint; treat as sensitive as credentials.
- data.maxResolutionstringMaximum resolution for the live broadcast (e.g., 1080p).
- data.createdAtstringTimestamp for when the stream was created (e.g., 2023-12-06T09:12:28.808Z).
- data.reconnectWindowintegerTime (in seconds) Fastpix will wait before declaring the stream over after disconnection; defaults to 60 seconds for Standard Latency streams.
- data.maxDurationintegerDuration (in seconds) that a live stream can last before disconnecting (e.g., 500).
- data.srtSecertstringUnique key used for streaming to a FastPix endpoint; treat it as sensitive as credentials.
- dataTrailbooleanIndicates if trails for streaming are enabled (e.g.,true/false).
- data.enableRecordingbooleanIndicates if recording is enabled (e.g., true/false).
- data.mediapolicystringAccess policy for the data (e.g., public, private).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {key1:value1}).
- data.lowLatencybooleanIndicates if lowLatency is enabled for stream (e.g., true/false).
- data.playback_idsobject
-- data.playback_ids.idstringUnique identifier for the PlaybackID (e.g., public).
-- data.playback_ids[].accessPolicystringAccess policy for playback IDs; possible values: public, private.
- data.srtPlaybackresponseobject
-- data.srtPlaybackResponse.srtPlaybackStreamIdstringUnique stream ID with initial play (max 255 characters; e.g., playf21f7c0b45108a04f051692e83af2943).
-- data.srtPlaybackResponse.srtPlaybackSecertstringUnique stream key (max 255 characters).
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.idle

This event occurs when the stream is no longer active, and there’s no encoder connected. It represents an idle or dormant state where the live stream is technically available but not in use. Use this to reset your UI or monitoring tools.


NameTypeDescription
typestringType for the webhook event.
webhookIdstringUnique identifier for the webhook.
objectobject
- object.namestringType of webhook (e.g., live).
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
workspaceobject
- workspace.namestringName for the environment (e.g., "production").
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
dataobject
- data.testbooleanIndicates if the stream is a test stream (duration of five minutes; recorded asset removed after a day).
- data.streamIdstringUnique identifier for the stream (max 255 characters, e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.statusstringCurrent live stream status: idle (no broadcast), disabled (no more RTMP streams), active (broadcast in progress).
- data.audioOnlybooleanIf set to false, the stream processes only the audio track.
- data.streamKeystringUnique key for streaming to a Fastpix RTMP endpoint; treat as sensitive as credentials.
- data.maxResolutionstringMaximum resolution for the live broadcast (e.g., 1080p).
- data.createdAtstringTimestamp for when the stream was created (e.g., 2023-12-06T09:12:28.808Z).
- data.reconnectWindowintegerTime (in seconds) Fastpix will wait before concluding the recorded asset after disconnection; defaults to 60 seconds for Standard Latency streams.
- data.maxDurationintegerDuration (in seconds) that a live stream can last before disconnecting (e.g., 500).
- data.srtSecertstringUnique key used for streaming to a FastPix endpoint; treat it as sensitive as credentials.
- dataTrailbooleanChecking the trails for streaming enabled or not (e.g., true/false).
- data.enableRecordingbooleanChecking the recording is enabled or not (e.g., true/false).
- data.mediapolicystringAccess policy for the data (e.g., public, private).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {key1:value1}).
- data.lowLatencybooleanData with lowLatency is enabled for stream (e.g., true/false).
- data.playback_idsobject
-- data.playback_ids.idstringUnique identifier for the PlaybackID (e.g., public).
-- data.playback_ids[].accessPolicystringAccess policy for playback IDs; possible values: public, private.
- data.srtPlaybackresponseobject
-- data.srtPlaybackResponse.srtPlaybackStreamIdstringUnique identifier id for the stream with initial play and max of 255 characters (e.g., playf21f7c0b45108a04f051692e83af2943).
-- data.srtPlaybackResponse.srtPlaybackSecertstringUnique identifier key for the stream, max of 255 characters.
created_atstringTimestamp for when the webhook was created (e.g., "2023-12-06T09:12:28.808Z").
attemptsarrayList of attempts created.

video.live_stream.preparing

NameTypeDescription
typestringType for the webhook event.
webhookIdstringUnique identifier for the webhook.
objectobject
- object.namestringType of webhook (e.g., live).
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
workspaceobject
- workspace.namestringName for the environment (e.g., production).
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
dataobject
- data.testbooleanIndicates if the stream is a test stream (duration of five minutes; recorded asset removed after a day).
- data.streamIdstringUnique identifier for the stream (max 255 characters, e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.statusstringCurrent live stream status: idle (no broadcast), disabled (no more RTMP streams), active (broadcast in progress), preparing (start broadcast).
- data.audioOnlybooleanIf set to false, the stream processes only the audio track.
- data.streamKeystringUnique key for streaming to a Fastpix RTMP endpoint; treat as sensitive as credentials.
- data.maxResolutionstringMaximum resolution for the live broadcast (e.g., 1080p).
- data.createdAtstringTimestamp for when the stream was created (e.g., 2023-12-06T09:12:28.808Z).
- data.reconnectWindowintegerTime (in seconds) Fastpix will wait before concluding the recorded asset after disconnection; defaults to 60 seconds for Standard Latency streams.
- data.maxDurationintegerDuration (in seconds) that a live stream can last before disconnecting (e.g., 500).
- data.srtSecertstringUnique key used for streaming to a FastPix endpoint; treat it as sensitive as credentials.
- dataTrailbooleanChecking the trails for streaming enabled or not (e.g., true/false).
- data.enableRecordingbooleanChecking the recording is enabled or not (e.g., true/false).
- data.mediapolicystringAccess policy for the data (e.g., public, private).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {key1:value1}).
- data.lowLatencybooleanData with lowLatency is enabled for stream (e.g., true/false).
- data.playback_idsobject
-- data.playback_ids.idstringUnique identifier for the PlaybackID (e.g., public).
-- data.playback_ids[].accessPolicystringAccess policy for playback IDs; possible values: public, private.
- data.srtPlaybackresponseobject
-- data.srtPlaybackResponse.srtPlaybackStreamIdstringUnique identifier id for the stream with initial play and max of 255 characters (e.g., playf21f7c0b45108a04f051692e83af2943).
-- data.srtPlaybackResponse.srtPlaybackSecertstringUnique identifier key for the stream, max of 255 characters.
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.updated

Triggered when there are changes to the live stream configuration, such as updates to metadata or when the streamKey is regenerated. Your system should use this event to sync live stream data with the latest version from the platform.


NameTypeDescription
typestringType for the webhook event.
webhookIdstringUnique identifier for the webhook.
objectobject
- object.namestringType of webhook (e.g., live).
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
workspaceobject
- workspace.namestringName for the environment (e.g., production).
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
dataobject
- data.testbooleanIndicates if the stream is a test stream (duration of five minutes; recorded asset removed after a day).
- data.streamIdstringUnique identifier for the stream (max 255 characters, e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.statusstringCurrent live stream status: idle (no broadcast), disabled (no more RTMP streams), active (broadcast in progress).
- data.audioOnlybooleanIf set to false, the stream processes only the audio track.
- data.streamKeystringUnique key for streaming to a Fastpix RTMP endpoint; treat as sensitive as credentials.
- data.maxResolutionstringMaximum resolution for the live broadcast (e.g., 720p).
- data.createdAtstringTimestamp for when the stream was created (e.g., 2023-12-06T09:12:28.808Z).
- data.reconnectWindowintegerTime (in seconds) Fastpix will wait before concluding the recorded asset after disconnection; defaults to 60 seconds for Standard Latency streams.
- data.maxDurationintegerDuration (in seconds) that a live stream can last before disconnecting (e.g., 700).
- data.srtSecertstringUnique key used for streaming to a FastPix endpoint; treat it as sensitive as credentials.
- dataTrailbooleanChecking the trails for streaming enabled or not (e.g., true/false).
- data.enableRecordingbooleanChecking the recording is enabled or not (e.g., true/false).
- data.mediapolicystringAccess policy for the data (e.g., public, private).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {"key1":"value1"}).
- data.lowLatencybooleanData with lowLatency is enabled for stream (e.g., true/false).
-- data.playback_ids.idstringUnique identifier for the PlaybackID (e.g., public).
-- data.playback_ids[].accessPolicystringAccess policy for playback IDs; possible values: public, private.
- data.srtPlaybackresponseobject
-- data.srtPlaybackResponse.srtPlaybackStreamIdstringUnique identifier id for the stream with initial play and max of 255 characters (e.g., playf21f7c0b45108a04f051692e83af2943).
-- data.srtPlaybackResponse.srtPlaybackSecertstringUnique identifier key for the stream, max of 255 characters.
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.deleted

Fired when a live stream has been permanently deleted. You should remove any references to this stream in your application, as it will no longer be available for connection or playback.


NameTypeDescription
typestringType for the webhook event.
webhookIdstringUnique identifier for the webhook.
objectobject
- object.namestringType of webhook (e.g., live).
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
workspaceobject
- workspace.namestringName for the environment (e.g., production).
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
dataobject
- data.testbooleanWhen true, the stream is identified as a test stream. Lasts five minutes; recorded asset is removed after a day.
- data.streamIdstringUnique identifier for the stream (max 255 characters, e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.statusstringCurrent live stream status: idle (no broadcast), disabled (no more RTMP streams), active (broadcast in progress).
- data.audioOnlybooleanIf false, the stream will only process the audio track.
- data.streamKeystringUnique key for streaming to a Fastpix RTMP endpoint; treat as sensitive as credentials.
- data.maxResolutionstringMaximum resolution for the live broadcast (e.g., 1080p).
- data.createdAtstringTimestamp for when the stream was created (e.g., 2023-12-06T09:12:28.808Z).
- data.reconnectWindowintegerTime (in seconds) Fastpix will wait before concluding the recorded asset after disconnection; defaults to 60 seconds for Standard Latency streams.
- data.maxDurationintegerDuration (in seconds) that a live stream can last before disconnecting (e.g., 500).
- data.srtSecertstringUnique key used for streaming to a FastPix endpoint; treat it as sensitive as credentials.
- dataTrailbooleanChecking the trails for streaming enabled or not (e.g., true/false)
- data.enableRecordingbooleanChecking the recording is enabled or not (e.g., true/false).
- data.mediapolicystringAccess policy for the data (e.g., public, private).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {"key1":"value1"}).
- data.lowLatencybooleanData with lowLatency is enabled for stream (e.g., true/false).
- data.playback_idsobject
-- data.playback_ids.idstringUnique identifier for the PlaybackID (e.g., public).
-- data.playback_ids[].accessPolicystringAccess policy for playback IDs; possible values: public, private.
- data.srtPlaybackresponseobject
-- data.srtPlaybackResponse.srtPlaybackStreamIdstringUnique identifier id for the stream with initial play and max of 255 characters (e.g., playf21f7c0b45108a04f051692e83af2943)
-- data.srtPlaybackResponse.srtPlaybackSecertstringUnique identifier key for the stream, max of 255 characters.
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.simulcast_target.created

Indicates that a new simulcast target has been added to the live stream. This is useful for updating the UI or logs to reflect that the stream will be relayed to another platform.


NameTypeDescription
typestringType for the webhook event.
webhookIdstringUnique identifier for the webhook.
objectobject
- object.namestringType of webhook (e.g., live).
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
workspaceobject
- workspace.namestringName for the environment (e.g., production).
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
dataobject
- data.simulcastIdstringUnique identifier for the simulcast (max 255 characters, e.g., 314a486a-3dc7-4cf5-9fcc-1708a4683f21).
- data.livestreamIdstringUnique identifier for the stream (max 255 characters, e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.rtmpUrlstringRTMP URL for linking to a third-party live streaming service (e.g., rtmp://hyd01.contribute.live-video.net/app/live_1012464221_DuM8W004MoZYNxQEZ0czODgfHCFBhk).
- data.streamKeystringUnique identifier used to transmit the main live stream to a third-party service (e.g., 81ta-sr0p-hrpr-t5tt-6bed).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {"key1":"value1"}).
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.simulcast_target.starting


NameTypeDescription
typestringType for the webhook event.
webhookIdstringUnique identifier for the webhook.
objectobject
- object.namestringType of webhook (e.g., live).
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
workspaceobject
- workspace.namestringName for the environment (e.g., production).
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
dataobject
- data.simulcastIdstringUnique identifier for the simulcast (max 255 characters, e.g., 314a486a-3dc7-4cf5-9fcc-1708a4683f21).
- data.livestreamIdstringUnique identifier for the stream (max 255 characters, e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.rtmpUrlstringRTMP URL for linking to a third-party live streaming service (e.g., rtmp://hyd01.contribute.live-video.net/app/live_1012464221_DuM8W004MoZYNxQEZ0czODgfHCFBhk).
- data.streamKeystringUnique identifier used to transmit the main live stream to a third-party service (e.g., 81ta-sr0p-hrpr-t5tt-6bed).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {"key1":"value1"}).
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.simulcast_target.broadcasting


NameTypeDescription
typestringType for the webhook event.
webhookIdstringUnique identifier for the webhook.
objectobject
- object.namestringType of webhook (e.g., live).
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
workspaceobject
- workspace.namestringName for the environment (e.g., production).
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
dataobject
- data.simulcastIdstringUnique identifier for the simulcast (max 255 characters, e.g., 314a486a-3dc7-4cf5-9fcc-1708a4683f21).
- data.livestreamIdstringUnique identifier for the stream (max 255 characters, e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.rtmpUrlstringRTMP URL for linking to a third-party live streaming service (e.g., rtmp://hyd01.contribute.live-video.net/app/live_1012464221_DuM8W004MoZYNxQEZ0czODgfHCFBhk).
- data.streamKeystringUnique identifier used to transmit the main live stream to a third-party service (e.g., 81ta-sr0p-hrpr-t5tt-6bed).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {"key1":"value1"}).
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.simulcast_target.deleted

Triggered when a simulcast target is removed from the live stream. You should update your app UI or backend systems to reflect that the stream is no longer being broadcast to that destination.


NameTypeDescription
typestringType for the webhook event.
webhookIdstringUnique identifier for the webhook.
objectobject
- object.namestringType of webhook (e.g., live).
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
workspaceobject
- workspace.namestringName for the environment (e.g., production).
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
statusStringMessage of status displayed.
dataobject
- data.successbooleanStatus will be displayed if the data success (e.g., true, false)
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.simulcast_target.updated


NameTypeDescription
typestringType for the webhook event.
webhookIdstringUnique identifier for the webhook.
objectobject
- object.namestringType of webhook (e.g., live).
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
workspaceobject
- workspace.namestringName for the environment (e.g., production).
- workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6).
statusStringMessage of status displayed.
dataobject
- data.successbooleanStatus will be displayed if the data success (e.g., true, false)
- data.simulcastIdstringUnique identifier for the simulcast (max 255 characters, e.g., 314a486a-3dc7-4cf5-9fcc-1708a4683f21).
- data.livestreamIdstringUnique identifier for the stream (max 255 characters, e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.rtmpUrlstringRTMP URL for linking to a third-party live streaming service (e.g., rtmp://hyd01.contribute.live-video.net/app/live_1012464221_DuM8W004MoZYNxQEZ0czODgfHCFBhk).
- data.streamKeystringA unique identifier used to transmit the main live stream to a third-party service (e.g., 81ta-sr0p-hrpr-t5tt-6bed).
- data.isEnabledbooleanMessage of the data will be updated (e.g., true, false)
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {key1:value1}).
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.srt_detected


NameTypeDescription
typestringType for the webhook event
webhookIdstringUnique identifier for the webhook
objectobject
- object.namestringType of webhook (e.g., live)
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
Workspaceobject
- Workspace.namestringName for the environment (e.g., production)
- Workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
dataobject
- data.testbooleanIndicates if the stream is a test stream. Test streams last five minutes and are removed after a day.
- data.streamIdstringUnique identifier for the stream. Max 255 characters (e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.statusstringCurrent live stream status: idle (no broadcast), disabled (no RTMP streams), active (broadcast in progress), preparing (checking broadcast).
- data.audioOnlybooleanIf set to false, the stream processes only the audio track.
- data.streamKeystringUnique key used for streaming to a Fastpix RTMP endpoint; treat it as sensitive as credentials.
- data.srtSecertstringUnique key used for streaming to a FastPix endpoint; treat it as sensitive as credentials.
- dataTrailbooleanChecking the trails for streaming enabled or not (e.g., true, false)
- data.maxResolutionstringMaximum resolution for the live broadcast (e.g., 1080p).
- data.enableRecordingbooleanChecking the recording is enabled or not (e.g., true, false).
- data.mediapolicyStringAccess policy for the data (e.g., public, private ..).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {key1:value1}).
- data.createdAtstringTimestamp for when the stream was created (e.g., 2023-12-06T09:12:28.808Z).
- data.reconnectWindowintegerTime (in seconds) Fastpix will wait before declaring the stream over after disconnection. Default is 60 seconds for Standard Latency.
- data.maxDurationintegerDuration (in seconds) that a live stream can last before disconnecting (e.g., 500).
- data.lowLatencybooleanData with lowLatency is enabled for stream (e.g., true, false).
- data.playback_idsobject
-- data.playback_ids.idstringUnique identifier for the PlaybackID (e.g., public).
-- data.playback_ids[].accessPolicystringAccess policy for playback IDs; can be public or private.
- data.srtPlaybackResponseobject
- data.srtPlaybackResponse.srtPlaybackStreamIdStringUnique identifier id for the stream with initial play and max of 255 characters (e.g., playf21f7c0b45108a04f051692e83af2943)
- data.srtPlaybackResponse.srtPlaybackSecertStringUnique identifier key for the stream, max of 255 characters.
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.

video.live_stream.rtmps_detected


NameTypeDescription
typestringType for the webhook event
webhookIdstringUnique identifier for the webhook
objectobject
- object.namestringType of webhook (e.g., live)
- object.idstringUnique identifier for the livestream (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
Workspaceobject
- Workspace.namestringName for the environment (e.g., production)
- Workspace.idstringUnique identifier for the environment (e.g., 9oa85f64-5717-4562-b3fc-2c963f66afa6)
dataobject
- data.testbooleanIndicates if the stream is a test stream. Test streams last five minutes and are removed after a day.
- data.streamIdstringUnique identifier for the stream. Max 255 characters (e.g., a0ba2bf6-fe6b-441c-a9be-bf910d223218).
- data.statusstringCurrent live stream status: idle (no broadcast), disabled (no RTMP streams), active (broadcast in progress), preparing (checking broadcast).
- data.audioOnlybooleanIf set to false, the stream processes only the audio track.
- data.streamKeystringUnique key used for streaming to a Fastpix RTMP endpoint; treat it as sensitive as credentials.
- data.srtSecertstringUnique key used for streaming to a FastPix endpoint; treat it as sensitive as credentials.
- dataTrailbooleanChecking the trails for streaming enabled or not (e.g., true/false)
- data.maxResolutionstringMaximum resolution for the live broadcast (e.g., 1080p).
- data.enableRecordingbooleanChecking the recording is enabled or not (e.g., true/false).
- data.mediapolicyStringAccess policy for the data (e.g., public, private ..).
- data.metadataobjectUser-supplied metadata included in the stream details (e.g., {key1:value1}).
- data.createdAtstringTimestamp for when the stream was created (e.g., 2023-12-06T09:12:28.808Z).
- data.reconnectWindowintegerTime (in seconds) Fastpix will wait before declaring the stream over after disconnection. Default is 60 seconds for Standard Latency.
- data.maxDurationintegerDuration (in seconds) that a live stream can last before disconnecting (e.g., 500).
- data.lowLatencybooleanData with lowLatency is enabled for stream (e.g., true/false).
- data.playback_idsobject
-- data.playback_ids.idstringUnique identifier for the PlaybackID (e.g., public).
-- data.playback_ids[].accessPolicystringAccess policy for playback IDs; can be public or private.
- data.srtPlaybackResponseobject
- data.srtPlaybackResponse.srtPlaybackStreamIdStringUnique identifier id for the stream with initial play and max of 255 characters (e.g., playf21f7c0b45108a04f051692e83af2943)
- data.srtPlaybackResponse.srtPlaybackSecertStringUnique identifier key for the stream, max of 255 characters.
created_atstringTimestamp for when the webhook was created (e.g., 2023-12-06T09:12:28.808Z).
attemptsarrayList of attempts created.