Skip to main content

Overview

Instead of polling the Get Video Details endpoint, configure a webhook URL when creating a video to receive a notification when processing completes.
Recommended: Always use webhooks for production applications. Polling is inefficient and can hit rate limits.

Setting Up Webhooks

Include a webhook URL in your video creation request:

Webhook Payload

When your video completes, Hooked sends a POST request to your webhook URL:

Success

Failure

Payload Fields

Implementation Example

Retry Policy

If your endpoint doesn’t return a 200 status, Hooked retries: After 3 failed attempts, no more retries are made.
Always return 200 OK immediately, even if your processing fails. This prevents unnecessary retries.

Webhooks Guide

In-depth webhook guide with security and testing

Get Video Details

Poll video status as an alternative

List Videos

View all your videos

Error Handling

Handle errors gracefully