How do I verify that a webhook really came from ShortGenius?

Every delivery includes a ShortGenius-Signature header in the form t= ,v1= . Compute an HMAC-SHA256 of `${t}.${rawBody}` using your endpoint's whsec_ secret and compare it to the v1 value; signatures are valid for 5 minutes to guard against replays.

What does the payload look like?

Each delivery is a JSON event with four fields: id, type, created, and data. The type tells you which event fired, and data carries the relevant details for that event.

What happens if my endpoint is down?

Failed deliveries are automatically retried with exponential backoff, so a temporary outage on your side won't cause you to permanently miss events.

Where do I get the signing secret, and how do I manage endpoints?

The signing secret is returned once when you create an endpoint, so store it securely at that moment. You can create and manage endpoints through the ShortGenius API, CLI, or the no-code connectors.

Webhooks integration

Get notified the moment ShortGenius media is ready

Subscribe an endpoint to ShortGenius webhooks and receive signed, real-time events when videos, images, audio, and series are created, completed, or published — so your app reacts instantly instead of polling.

Set up in 2 minutes All integrations

What is Webhooks?

Webhooks let ShortGenius push lifecycle events to your own endpoint as they happen, instead of you repeatedly polling the API. When you create a webhook endpoint, you choose which events to subscribe to and receive a signing secret. From then on, ShortGenius sends a JSON payload to your URL whenever a subscribed event fires — video.created, video.completed, video.published, series.created, image.completed, or audio.completed — letting you trigger downstream automations the instant media is ready.

What you can do with Webhooks

Once Webhooks is connected, you can drive ShortGenius with plain-language prompts.

Subscribe to six lifecycle events: video.created, video.completed, video.published, series.created, image.completed, and audio.completed

Receive a JSON event payload with id, type, created, and data fields for every delivery

Verify each delivery with an HMAC-SHA256 signature in the ShortGenius-Signature header

Trust signatures with a 5-minute validity window to reject stale or replayed requests

Rely on automatic retries with exponential backoff when your endpoint fails to respond

Create and manage endpoints through the API, CLI, or no-code connectors

Set up ShortGenius webhooks

Create an endpoint, then verify the signature on every delivery.

1
Create an endpoint
Register a URL via the API, CLI, or a connector. The signing secret (whsec_…) is returned once — store it.
```
shortgenius webhooks create --url https://example.com/hooks --events "video.completed"
```
2
Receive events
ShortGenius POSTs a JSON event { id, type, created, data } to your URL for each subscribed event.
3
Verify the signature
Each delivery carries a ShortGenius-Signature header (t=<unix>,v1=<hex>). Compute HMAC-SHA256 of `${t}.${rawBody}` with your secret, compare in constant time, and reject if it differs or t is older than 5 minutes.
4
Respond 2xx
Return a 2xx status quickly. Failed deliveries are retried with exponential backoff.

Frequently Asked Questions

You can subscribe to six lifecycle events: video.created, video.completed, video.published, series.created, image.completed, and audio.completed. Each endpoint chooses exactly which of these it wants to receive.

More ways to connect

ShortGenius speaks MCP, REST, and webhooks.

Claude Claude Code Cursor Codex OpenCode Zapier n8n Make.com SDK CLI

Ready to connect Webhooks?

Create a free account and generate an API key to get started in minutes.

Start free

Get notified the moment ShortGenius media is ready

What is Webhooks?

What you can do with Webhooks

Set up ShortGenius webhooks

Create an endpoint

Receive events

Verify the signature

Respond 2xx