Convoy - Open Source Webhooks Gateway

TL;DR

TL;DR: Convoy is an open-source webhook gateway written in Go that handles ingestion, delivery, retries, and observability for millions of webhooks — deployable via Docker or Kubernetes.

Source and Accuracy Notes

⚠️ This section is MANDATORY. All links must be verified from actual source, not guessed.

• Project page: getconvoy.io
• Source repository: github.com/frain-dev/convoy
• License: Elastic License v2.0 (verified via README)
• HN launch thread: news.ycombinator.com/item?id=35369983
• Source last checked: 2026-06-30 (commit main, 2,827 stars)

What Is Convoy?

Convoy is an open-source, cloud-native webhooks gateway built in Go. It sits at the edge of your network to ingest events from your microservices and deliver them to your users, while also receiving webhooks from external providers and routing them internally — keeping your internal systems off the public internet.

From the official README:

Convoy is an open source high-performance webhooks gateway used to securely ingest, persist, debug, deliver and manage millions of events reliably with rich features such as retries, rate limiting, static ips, circuit breaking, rolling secrets and more.

Core Features

Webhooks Gateway

Convoy streams webhooks both inbound (from providers) and outbound (to customers). Your internal services never need a public-facing endpoint — everything routes through Convoy.

Scalability

Designed for horizontal scaling, Convoy’s architecture separates the API server, workers, scheduler, and socket server as independently scalable components.

Security

• Payload signing — verify message integrity with HMAC signatures
• Bearer token authentication — authenticated endpoint access
• Static IPs — for network environments with strict firewall rules
• Rolling secrets — automated secret rotation

Retries and Batch Retries

Two retry algorithms are supported:

• Constant time
• Exponential backoff with jitter

For sustained failures, batch retries cover endpoints that have consecutively failed retried events.

Rate Limiting

Convoy throttles event delivery per endpoint at configurable rates, even when ingesting at high volume.

Fan Out

Route a single event to multiple endpoints based on event type or payload structure.

Customer-Facing Dashboards

Embeddable iframe dashboards let your users debug webhooks, retry events, add endpoints, and configure subscriptions — without granting access to your internal systems.

Endpoint Failure Notifications

When an endpoint consecutively fails to process events, Convoy disables it and sends email or Slack notifications.

Installation

Convoy can be deployed via Docker or Kubernetes with Helm.

Docker

docker run -d -p 5005:5005 \
  -e CONVOY_DB_HOST=localhost \
  -e CONVOY_DB_PASSWORD=postgres \
  -e CONVOY_DB_USERNAME=postgres \
  -e CONVOY_DB_DATABASE=convoy \
  -e CONVOY_PORT=5005 \
  -e CONVOY_REDIS_HOST=localhost \
  -e CONVOY_REDIS_PASSWORD=redis \
  -e CONVOY_SERVER_URL=https://your-convoy-instance.com \
  frain-dev/convoy:latest

Full Docker setup guide: docs.getconvoy.io/deployment/install-convoy/docker

Kubernetes with Helm

helm repo add frain-dev https://frain-dev.github.io/helm-charts
helm repo update
helm install convoy frain-dev/convoy

Full Kubernetes setup: docs.getconvoy.io/deployment/install-convoy/kubernetes

Architecture Overview

Convoy’s components:

| Component | Role | |---|---| | API Server | Handles incoming API requests and webhook ingestion | | Workers | Process and deliver webhook events | | Scheduler | Manages retry scheduling and batch operations | | Socket Server | Real-time webhook event streaming | | Message Queue | Built-in queue for reliable event persistence |

Comparison to Alternatives

| Feature | Convoy | Hookdeck | Ngrok | |---|---|---|---| | Open source | ✅ | ❌ | ❌ | | Self-hosted | ✅ | ❌ | Partial | | Kubernetes support | ✅ Helm | ❌ | ❌ | | Customer dashboards | ✅ Embeddable | ✅ | ❌ | | Static IPs | ✅ | ❌ | ✅ | | Batch retries | ✅ | ❌ | ❌ | | Exponential backoff | ✅ | ✅ | ❌ |

FAQ

Q: Is Convoy free to use? A: Convoy is open source under the Elastic License v2.0. You can self-host it at no cost. The project also offers a hosted cloud version at getconvoy.io with a free tier.

Q: What databases does Convoy support? A: Convoy supports PostgreSQL as its primary datastore. Redis is used for caching and real-time features. Both are required for a production deployment.

Q: How does Convoy handle webhook delivery reliability? A: Convoy uses configurable retry algorithms (constant time or exponential backoff with jitter) and automatically disables failing endpoints after consecutive failures. It also supports batch retries for manual intervention on sustained failures.

Q: Can I white-label the dashboard for my customers? A: Yes. Convoy provides embeddable iframe dashboards that you can white-label and expose directly to your end users for debugging and endpoint management.

Q: Does Convoy support static IP assignment? A: Yes, static IPs are available — important for enterprise environments with strict egress firewall rules.

Conclusion

Convoy fills the gap between “just sending webhooks” and running a full enterprise integration platform. With 2,800-plus GitHub stars, active development, and a production-tested feature set that includes retries, rate limiting, fan-out routing, and customer-facing dashboards, it is a credible self-hosted alternative to managed services like Hookdeck or Svix.

For platform engineers building multi-tenant SaaS or managing high-volume webhook pipelines, Convoy’s Kubernetes-native deployment model and open-source license make it worth evaluating seriously.