Vidgrid Webhooks

generated: '2026-07-21'
method: searched
source: https://developer.vidgrid.com/docs/v2/ (Webhooks section)
type: Webhooks
note: >-
  VidGrid documents webhooks but publishes no AsyncAPI specification. This captures the
  documented webhook catalog verbatim from the v2 API reference; do not treat it as a
  provider-published AsyncAPI document.
configuration:
  settings_url: https://app.vidgrid.com/webhooks
  extras: >-
    webhook_extras set when creating a token (POST /vidgrid/v2/tokens) is delivered in
    the extras field of fired events.
  replay: POST /vidgrid/v2/webhooks requests a webhook event be fired for a given video.
payload:
  fields:
  - {name: event_type, description: The event type that fired.}
  - {name: data, description: The resource object (Video or Caption Resource) the event concerns.}
  - {name: extras, description: Optional custom data attached via webhook_extras.}
  - {name: token, description: Deprecated field.}
events:
- name: VIDEO_UPLOADED
  resource: video
  description: A video finished uploading.
- name: VIDEO_FAILED
  resource: video
  description: A video failed processing.
- name: VIDEO_READY
  resource: video
  description: A video is processed and ready.
- name: CAPTION_REQUESTED
  resource: caption
  description: A caption was requested for a video.
- name: CAPTION_READY
  resource: caption
  description: A requested caption is ready.
- name: CAPTION_FAILED
  resource: caption
  description: A caption request failed.