Site icon Filestack Blog

Filestack Webhook Upgrades: 100x Capacity & Real-Time Analytics

Filestack webhooks update

We’re rolling out improvements to how webhooks are processed and delivered, with 100x greater capacity, 2x faster delivery, and full visibility into your event-driven workflows.

This is a backend infrastructure upgrade. Your existing webhook configurations, payload formats, and signature validation all continue to work exactly as they do today.

Key Takeaways

100x Capacity, 2x Faster Delivery

The updated webhook system introduces a decoupled processing architecture built for significantly higher throughput. The service now handles 100x the request volume of the previous system, and the previous 1,500-request traffic ceiling has been removed entirely. The system scales with your usage.

Delivery is faster, too. Request latency has been reduced by nearly half, meaning your endpoints receive events sooner after they occur.

Events are now persisted to a message queue before delivery, so even if a downstream service is temporarily slow to respond, your webhook events stay queued and delivered in order once conditions improve. In practice, this means more consistent delivery during traffic spikes and more predictable behavior under load.

Smarter Retry Logic

The existing retry policy (three attempts at 5 minutes, 30 minutes, and 12 hours) remains in place, and the underlying delivery mechanism is now more resilient to transient failures. The system automatically manages rate limiting per destination URL, so an endpoint returning temporary errors is isolated from your other configured webhooks.

If a webhook URL is consistently failing, the system flags it and keeps delivery performance intact for the rest of your endpoints.

New Webhooks Analytics in the Developer Portal

Each configured webhook endpoint now surfaces an Error Rate column directly in the endpoint list, giving you an at-a-glance health check from the configuration page.

Clicking into an endpoint’s error rate opens a Success vs Failure time-series chart. You can filter by time window to understand delivery trends over the last hour, day, or longer.

Error Rate Per Endpoint

Each configured webhook now surfaces an Error Rate column directly in the endpoint list, giving you an at-a-glance health check without navigating away from the configuration page.

Webhook list with Error Rate column

The webhook endpoint list now includes an Error Rate column alongside Status, URL, Type, and Secret. Each row represents a separately configured endpoint, with green status indicators confirming active delivery.

Error Rate column close-up

A closer look at the Error Rate badges per endpoint. Values show  when there are no recent errors, making it easy to spot a degraded endpoint at a glance.

Success vs Failure Chart

Clicking into the error rate box per endpoint opens a detailed analytics view with a Success vs Failure time-series chart. You can filter by time window to understand delivery trends over the last hour, day, or longer.

Success vs Failure chart with no data

The Success vs Failure chart before any events have been delivered in the selected time window. The chart updates automatically as events are processed.

Success vs Failure chart showing a successful delivery

The same chart after a successful webhook delivery — the green bar in the 16:38→16:43 interval confirms a fp.upload event was delivered and acknowledged by the endpoint.

Zero Changes Required

This is purely an infrastructure-level upgrade. Your existing webhook integration continues to work with no code changes, configuration updates, or redeployment. The event payload structure, HMAC-SHA256 signature validation, and the FS-Timestamp / FS-Signature headers all remain identical. If you’re already validating webhook signatures using our SDK or your own implementation, everything carries over.

The same seven event types are supported — and you can subscribe to all of them or target a specific one from the webhook setup page in the Developer Portal:

Webhook setup page showing the event type selector dropdown

The webhook configuration UI lets you enter your endpoint URL and filter by event type. Choose All to receive every event, or narrow it down to a specific type, such as File upload, Workflow, or Video conversion.

Event type dropdown expanded.

Available event types in the dropdown: File conversion, File upload, File export, Video conversion, Workflow, File overwrite, and File deletion.

Here’s an example of a real fp.upload payload delivered to an endpoint after a file is stored:

Sample fp.upload webhook payload

A live fp.upload event payload showing the event ID, action type, timestamp, and file details including URL, filename, MIME type, size, and storage status.

What This Means for Workflows

If you’re using Filestack Workflows, webhooks are the mechanism that delivers your job results. These reliability improvements apply directly here. Workflow job results benefit from the same queuing and ordered delivery guarantees, which are especially relevant for high-volume processing pipelines where multiple jobs complete in quick succession.

Timeline

These improvements are rolling out progressively. There is nothing you need to do. Your existing webhook configurations in the Developer Portal are automatically carried over. The Webhooks Analytics dashboard will appear in the Developer Portal once the rollout is complete.

We’ll update the webhooks documentation with additional details as they become relevant.

Questions?

If you have questions about the webhook upgrade or want to discuss your specific use case, reach out to our support team or check the webhooks documentation.

Exit mobile version