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: Try to implement 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.
Additional Debugging Info
With this feature enabled, outgoing webhooks will contain an additional "debugging" property on the Image object. This data will let you know which URLs Bannerbear attempted to load, which failed, timed-out, or were successfully loaded.
Enable Additional Debugging Info:
- Head to your Project
- Click Settings / API Key
- Advanced →
- Scroll down to Additional Debugging Info
- Select Enabled from the drop-down menu
- Save
