Webhooks

Your application can use webhooks to get notifications from Editframe about events related to your Editframe application and videos

Update your Editframe application's webhook endpoint in the dashboard

Events

Editframe sends a request to your webhook endpoint for the following events, indicated by the event property in the webhook body:

video.created
video.failed
webhook.test

Video events

Tip

You can encode videos synchronously if you prefer not to set up a webhook endpoint

Video created

This event indicates that video encoding succeeded

Body properties

Property	Value
`download_url`	Video download url
`event`	`'video.created'`
`id`	Video id
`metadata`	Video metadata
`stream_url`	Video stream url
`thumbnail_url`	Video thumbnail url
`timestamp`	Unix timestamp of the time the video was transcoded

Example body

{
  "download_url": "https://api.editframe.com/v2/videos/kdZ2mNbxJg/download?client_id=GbjsM0enkgOOyKOqd7QnJZ",
  "event": "video.created",
  "id": "kdZ2mNbxJg",
  "metadata": {},
  "stream_url": "https://api.editframe.test/v2/videos/kdZ2mNbxJg/stream?client_id=GbjsM0enkgOOyKOqd7QnJZ",
  "thumbnail_url": "https://api.editframe.test/v2/videos/kdZ2mNbxJg/thumbnail?client_id=GbjsM0enkgOOyKOqd7QnJZ",
  "timestamp": 1651784008
}

Video failed

This event indicates that video encoding failed

Body properties

Property	Value
`event`	`'video.failed'`
`id`	Video ID
`metadata`	Video metadata
`timestamp`	Unix timestamp of the time the webhook request was made

Example body

{
  "event": "video.failed",
  "id": "yKOqd7QnJZ",
  "metadata": {},
  "timestamp": 1651781472
}

Test event

This event is sent when you update your webhook to ensure it works

Example

{
  "event": "webhook.test",
  "timestamp": 1651780129
}

Test webhooks in the browser

You can test webhooks for your application without building your own webhook endpoint using Webhook.site:

Visit Webhook.site
Copy the URL labeled Your unique URL
Paste the URL in the Webhook field in your dashboard
Render a video