Webhook Notifications

Receive real-time event updates from Visla via webhooks to keep your application synchronized with project, asset, and user activities.

When operations complete, Visla sends HTTP POST requests to your webhook URL with event information.

Webhook Payload Structure

{
  "eventId": "evt_123456789",
  "eventType": "project_generation",
  "targetId": "proj_123456789",
  "targetType": "project",
  "eventTime": 1704110400000,
  "eventStatus": "success",
  "eventMessage": null
}

Webhook Event Types

Event TypeIDDescriptionTarget TypeTrigger
project_generation10Video generation finishedprojectAfter video generation completes
project_export20Video export completedclipAfter export-video finishes

Webhook Examples

Project Generation Success:

{
  "eventId": "evt_gen_456",
  "eventType": "project_generation",
  "targetId": "proj_123456789",
  "targetType": "project",
  "eventTime": 1704112200000,
  "eventStatus": "success",
  "eventMessage": null
}

Project Generation Failure:

{
  "eventId": "evt_gen_789",
  "eventType": "project_generation",
  "targetId": "proj_123456789",
  "targetType": "project",
  "eventTime": 1704112800000,
  "eventStatus": "failed",
  "eventMessage": "Insufficient credits for video generation"
}

Video Export Success:

{
  "eventId": "evt_export_321",
  "eventType": "project_export",
  "targetId": "clip_987654321",
  "targetType": "clip",
  "eventTime": 1704113400000,
  "eventStatus": "success",
  "eventMessage": null
}

Video Export Failure:

{
  "eventId": "evt_export_654",
  "eventType": "project_export",
  "targetId": "clip_987654321",
  "targetType": "clip",
  "eventTime": 1704114000000,
  "eventStatus": "failed",
  "eventMessage": "Export timeout after 30 minutes"
}