Can I use Webhooks to be notified of missing images?

Images sometimes fail to load for multiple reasons, leaving a blank space or a placeholder image in its place. Bannerbear webhooks contain a header ("bannerbear-image-fail") that serves to notify you when this happens.

This flag indicates that a failure happened at some point, and is added even if an external image fails and is subsequently successfully loaded via the Bannerbear retry logic.

You can use this flag to build your own notification or retry logic for such cases.

Note: We'd suggest implementing some kind of maximum retry count as it could result in an endless loop if the reason for failure is an external image that is non-existing.

Start a Free Trial

Start a free trial with 30 API credits, no credit card required

Resize Video
Add Intro Animation
Add Subtitles

Get Started for Free