Repolode
Submit
frain-dev

frain-dev/convoy

Open source webhooks gateway that ingests, persists, delivers and debugs webhook events with retries, rate limiting and circuit breaking.

Open-source alternative to:SvixHookdeck

View on GitHubWebsite
Stars
2,887
Forks
188
Open issues
45
Last commit
yesterday

What is it?

Convoy is a webhooks gateway that sits at the edge of a network. It receives webhooks from third-party providers and routes them to internal services, and it also streams webhooks from internal systems out to customer endpoints, so internal services are not directly exposed to the public internet.

For delivery, Convoy throttles traffic per endpoint, retries failed deliveries with constant or exponential backoff with jitter, and offers batch retries for endpoints that repeatedly fail. When an endpoint fails consecutively, the circuit opens and is probed before traffic resumes, and the endpoint can be disabled with a notification sent by email, Slack or Microsoft Teams. Subscriptions can filter on body, headers, query and path, and run a JavaScript transform before delivery.

The project ships as separate server and agent components that scale independently. It also provides a customer-facing dashboard that can be embedded via iframe, generated SDKs for Go, Python, JavaScript, Ruby, PHP and Java, and deployment options with Docker and Helm.

Key features

  • 01Ingests and routes incoming webhooks from providers to internal services
  • 02Delivers outgoing webhooks with per-endpoint rate limiting and configurable retries
  • 03Circuit breaking that probes failing endpoints before resuming traffic
  • 04Fan-out of one event to multiple endpoints based on event type or payload
  • 05Payload signing, bearer token, OAuth2 and mTLS support for endpoints
  • 06Event search by metadata, JSON payload and idempotency key

Use cases

  • Relaying third-party provider webhooks to internal microservices without exposing them publicly
  • Delivering webhooks from a SaaS product to customer endpoints with retries and monitoring
  • Giving customers a self-service dashboard to debug and replay webhook events

Quick start

  1. 1

    Open the Docker install guide from the README

  2. 2

    Or follow the Kubernetes with Helm install guide from the README

Things to know

  • Licensed under the Elastic License v2.0, which is source-available rather than OSI open source and restricts offering it as a managed service.
  • The Postgres queue option is experimental and needs a license.
  • The free Community edition is limited to one user, one organisation, and two projects.

In collections

CLI & terminal toolsMicroservice frameworks & service infrastructure

Topics

#webhooks#api-gateway#message-queue#event-driven#retries#go#angular#automation#cli#cloud

FAQ

What is convoy?
Open source webhooks gateway that ingests, persists, delivers and debugs webhook events with retries, rate limiting and circuit breaking. Convoy is a webhooks gateway that sits at the edge of a network. It receives webhooks from third-party providers and routes them to internal services, and it also streams webhooks from internal systems out to customer endpoints, so internal services are not directly exposed to the public internet.
Is convoy free to use? What license does it have?
convoy is open source under the Other license. Check the license terms before using it in commercial products.
Is convoy still maintained?
Actively maintained. The last commit to convoy was on Nov 5, 2026.
What can I use convoy for?
Relaying third-party provider webhooks to internal microservices without exposing them publicly Delivering webhooks from a SaaS product to customer endpoints with retries and monitoring Giving customers a self-service dashboard to debug and replay webhook events
How do I install convoy?
Open the Docker install guide from the README Or follow the Kubernetes with Helm install guide from the README
Where can I get convoy?
The source code and installation instructions are on GitHub: https://github.com/frain-dev/convoy

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects