Skip to main content
You need an API key (hk_prod_…) from your Hooper contact and a public HTTPS URL that can receive webhooks.
1

Register a webhook endpoint

The response includes "secret": "hws_prod_…" exactly once — store it. You’ll use it to verify deliveries.
2

Submit a video

The simplest source is a public Veo match page or an HTTPS link to an MP4:
The X-Hooper-Cost-Cents header tells you what was held. To upload your own file instead, see Sessions → Sources.
3

Receive the result

Minutes to an hour later (depending on length), your endpoint receives:
Verify the Hooper-Signature header before trusting it — see Webhooks. Prefer polling? GET /v1/sessions/sess_18234 returns the same object.
Use metadata to carry your own ids. It is echoed on the session and inside every event, so you never need a mapping table.