Skip to main content

Test and manage webhook deliveries

Use an endpoint's controls to verify delivery, inspect failures, and manage whether it receives new render notifications.

When to use it​

Use these controls after adding a webhook, when your receiver changes, or when notifications stop arriving.

Send a test and inspect the result​

Location: Dashboard → Webhooks → endpoint card.

  1. Open Webhooks and find your endpoint by its URL or description.
  2. If its status is disabled, click Enable.
  3. Click Send test.
  4. Wait for Test delivery queued — check your receiver.
  5. Check your receiver, then click Deliveries on the endpoint card.

Webhook endpoint controls showing subscribed events, Send test, Signing secret, Deliveries, Disable, and the delete icon.

The test sends a synthetic render.completed event with test: true, even if your endpoint subscribes only to failures. It does not create a video or spend render credits; sample media URLs and credit values in its payload are illustrative.

The Deliveries panel shows the latest 10 records. Each record includes its status, event, attempt count, creation time, and, when available, HTTP response code and error message. To load updated results, close and reopen Deliveries.

Delivery statusMeaning
pendingThe event is waiting for delivery or another attempt.
successThe receiver returned a successful HTTP response.
failedDelivery could not complete; inspect the displayed error.

View or copy the signing secret​

  1. Click Signing secret on the endpoint card.
  2. Click Copy secret in Signing Secret.
  3. Store it in your receiver's secret configuration, then click Done.

See signature verification for the exact algorithm and request headers.

Pause and resume notifications​

  1. Click Disable to pause an active endpoint.
  2. Confirm that its status changes to disabled.
  3. When the receiver is ready, click Enable and send a new test.

Disabling preserves the URL, events, and secret and continues to use a plan slot. Delivery attempts check the endpoint's current status; a request already sent cannot be recalled. Enabling clears the consecutive-failure count but does not replay missed events.

Delete an endpoint​

  1. Find the endpoint you want to remove.
  2. Click its trash icon labeled Delete webhook.
  3. Check the URL in the browser confirmation and confirm deletion.
Deletion cannot be undone

The endpoint configuration and secret are removed. New events and queued attempts cannot be delivered through that endpoint, and its card and delivery panel disappear from the dashboard. Existing delivery records are retained internally, but the dashboard provides no restore action. Creating the endpoint again gives it a new secret that your receiver must use.

Deleting an endpoint does not delete renders or recall notifications already sent. Use Disable when you only need a temporary pause.

Troubleshooting​

Send test was queued, but nothing arrived​

Cause: Queued confirms submission, not successful delivery. The receiver may be unavailable, the endpoint disabled, or the URL unreachable.

Solution: Check that the endpoint is active, open Deliveries, and inspect its HTTP code or error. Make the receiver return 2xx within 10 seconds without redirects, then send another test.

Deliveries keep failing​

Zvid makes up to five total attempts, including the first, with exponential backoff. A receiver must verify the signature against the original request body. Fix the response, timeout, public reachability, or signature problem reported by your receiver and delivery record.

After 20 consecutive deliveries exhaust their attempts, the endpoint is automatically disabled. Fix the receiver before clicking Enable, then Send test. There is no customer dashboard replay button for old events.