API Reference
Webhooks
InsightStream uses webhooks to notify your application when asynchronous events occur, such as video transcoding completion or billing updates.
Event Types
| Event | Description |
|---|---|
| video.asset.ready | Fired when a video has finished transcoding and is ready for playback. |
| video.asset.error | Fired if transcoding fails. |
| video.asset.deleted | Fired when an asset is successfully deleted from our servers. |
Webhook Payload
{
"id": "evt_12345",
"type": "video.asset.ready",
"created_at": "2025-12-28T17:42:00Z",
"data": {
"asset_id": "vid_38402122",
"duration": 124.52,
"max_resolution": "4k"
}
}
Verification
We recommend verifying the webhook signature to ensure the request came from InsightStream. We include an X-Is-Signature header in every request.
Updated on Dec 28, 2025
Was this page helpful?