Stream Status Callbacks
Last update：2026-10-19 14:43:09
Stream Status Callbacks sends an HTTP request to your service when ingest starts or ends. Use these notifications to update stream status in your application or trigger monitoring and other workflows.
Before you begin
- You have permission to configure the target ingest domain in the CDNetworks console.
- Your service has reachable endpoints for ingest start and end notifications. Both URLs must use the same protocol and domain.
- You know which HTTP method and parameters your service expects.
Configure stream status callbacks
-
Go to Media Delivery > Media Acceleration Live Broadcast > Configuration.
-
In the domain list, find the ingest domain, then choose Edit Configuration.
-
In the configuration editor, choose Live Streaming Features > Stream Status Callbacks, then choose Add.
If a Stream Status Callbacks configuration already exists, edit the existing row.
-
For Stream Status Callbacks, select On.
-
Configure the callback settings.
| Field | Required | Default | Description |
|---|---|---|---|
| Stream Status Callbacks | Yes | Off | Enable or disable notifications for ingest start and end events. |
| Callback Method | Yes | GET | Choose GET or POST, as required by your service. |
| Stream Start Callback URL | Yes | None | Enter the full URL for ingest start notifications, including the protocol, hostname or IP address, optional port, and path. |
| Stream End Callback URL | Yes | None | Enter the full URL for ingest end notifications, including the protocol, hostname or IP address, optional port, and path. |
| Callback Parameters | No | See default selections | Select the parameters to send and, if needed, rename them to match your service. |
Important: Both callback URLs must use the same protocol and domain. For example, use
https://example.com/live/startandhttps://example.com/live/end.
- Under Callback Parameters, expand Click configure. In Stream Start Parameters and Stream End Parameters, select the parameters for each event type.
- Choose Confirm and review the configuration. Choose Save Draft to save it as a draft, or Next to continue the domain configuration workflow.
Reference
Callback URL format
Use the following format for callback URLs:
{protocol}://{host}[:{port}]/{path}
The port is optional. For example:
https://example.com/live/start
http://192.0.2.10:8888/live/start
Callback parameters
Configure parameters separately for Stream Start Parameters and Stream End Parameters. Use the prefilled parameter names or enter names expected by your service. Blank means no name is prefilled. Clear a parameter to omit it from the request.
| Parameter | Default name | Default selection | Description |
|---|---|---|---|
| Ingest Client IP | ip |
Selected | IP address of the ingest client. |
| CDN Ingest Server IP | node |
Selected | IP address of the CDN ingest server that handled the stream. |
| Stream Name | id |
Selected | Name of the stream associated with the event. |
| Host | app |
Selected | Host value associated with the stream event. |
| Application Name | appname |
Selected | Application name associated with the stream. |
| MD5 | Blank | Not selected | MD5 value included with the callback when selected. |
| Ingest Connection Port | port |
Selected | Port used for the ingest connection. |
| Event Timestamp (Seconds) | Blank | Selected | Event timestamp in seconds. |
| Event Timestamp (Milliseconds) | milltime |
Not selected | Event timestamp in milliseconds. |
| Custom Callback Parameters | Blank | Optional | Custom parameters to include. Separate multiple parameter names with a semicolon (;). |