Video Annotations sent in Webhook


I am looking at setting up a webhook to process when labels are created/updated on a video dataset. I am using some annotations that use frames. Is there an example of the webhook export for that case? Is there a way to test what the json will look like in the payload so we can properly handle on our server?

Does the webhook json match the other export functions outputs?

Any help would be appreciated.

Thank you,

Hi @jordan.muraskin, here is an example of the webhook export for a video label:

=========== New Webhook Delivery ============
Delivery ID: clfkdk8ppaj9307f9gybba816
Payload: {
    "id": "clfkdfmge0dc307wufjyz22wj",
    "createdAt": "2023-03-23T00:28:04Z",
    "updatedAt": "2023-03-23T00:28:04Z",
    "secondsToLabel": 20.002,
    "label": "{\"objects\":[],\"classifications\":[],\"relationships\":[],\"frames\":\"\"}",
    "agreement": null,
    "benchmarkAgreement": null,
    "deleted": false,
    "skipped": false,
    "project": {
        "id": "clfkdf44e0cna07xff7q50jik",
        "createdAt": "2023-03-23T00:24:04Z",
        "updatedAt": "2023-03-23T00:24:22Z",
        "name": "webhook video",
        "description": "",
        "deleted": false
    "dataRow": {
        "id": "cldysx1k602xz07vw55pk7zhx",
        "createdAt": "2023-02-10T17:27:17Z",
        "updatedAt": "2023-02-10T17:27:17Z",
        "deletedAt": null,
        "externalId": null,
        "rowData": "",
        "labelCountInProject": 1
    "dataset": {
        "id": "cldyswxt501re07zz5uv5cgt7",
        "createdAt": "2023-02-10T17:27:12Z",
        "updatedAt": "2023-02-10T17:27:17Z",
        "name": "video_prediction_demo",
        "description": "",
        "deleted": false
    "user": {
        "id": "cktu4ft7o3xvq0y6t7z4khkty",
        "email": ""

As you can see in the label field, the frame-based details are accessible through a distinct URL. Instructions for accessing the labeled frames can be found here in our guides and here in our SDK reference.

Fortunately, as noted at the top of the first linked page, our format for the new Export v2 directly includes the details of every frame in the label. Soon, we will restructure our webhook payloads to match the Export v2 format, thus making the frame details accessible in the delivery.

Thank you for the quick reply.

When is the expected release of the v2 format?

@jordan.muraskin Apologies for the delay here. The v2 format was made available for webhooks in April!