Webhooks

Receive HTTP callbacks when Pollo events happen — generation lifecycle, billing thresholds, and key changes.

Configured endpoints

EndpointEventsStatusActions
https://api.yourapp.com/pollo/render-completegeneration.completedActive
https://api.yourapp.com/pollo/credits-lowbilling.threshold_reachedActive
https://hooks.slack.com/services/T0XXXXXX/...generation.failedPaused

Event types

  • generation.completed

    Fires when an async generation finishes — payload includes the asset URL.

  • generation.failed

    Fires when a generation fails — payload includes the error code and message.

  • billing.threshold_reached

    Fires when monthly spend crosses a threshold you configured.

  • key.rotated

    Fires when an API key is rotated, with the old key's identifier.

Example payload

{
  "event": "generation.completed",
  "id": "gen_a93f8c7e1b",
  "model": "veo-3",
  "duration_ms": 12480,
  "asset_url": "https://cdn.pollo.ai/renders/a93f8c7e1b.mp4",
  "credits_used": 162,
  "timestamp": "2026-05-23T11:08:42Z"
}