Convoy Webhooks

REST API at cloud.getconvoy.io/api/v1 (Cloud) or self-hosted equivalent. Resources: projects, endpoints, events, event_deliveries, subscriptions, sources. POST /projects/{id}/events publishes an event to a project (fanout to subscribed endpoints). GET /projects/{id}/event-deliveries lists delivery attempts with status. POST /projects/{id}/endpoints creates a new consumer endpoint. POST /projects/{id}/subscriptions creates a subscription mapping an event type to an endpoint. GET /projects/{id}/events/{id}/deliveries checks delivery status for a specific event. Request/response payloads are JSON. Pagination via next_page_cursor.

Standard HTTP status codes with JSON error bodies. 401 for invalid API key, 400 for invalid event payload, 404 for missing endpoint/project. Event delivery states: Processing, Success, Retry, Failed, Discarded. Failed deliveries viewable in delivery dashboard; manual re-queue via POST /event-deliveries/{id}/forcesend. Circuit breaker: Convoy pauses delivery to endpoints with consecutive failures and resumes after timeout. Convoy Cloud uptime at status.getconvoy.io. Self-hosted reliability depends on Redis (message queue) and PostgreSQL (state) deployment.

Convoy is a webhooks gateway — it sits between your application and webhook consumers, handling reliable delivery, retries, fanout, rate limiting, and circuit breaking. Two deployment modes: Convoy Cloud (managed) or self-hosted (Docker/Kubernetes, open source). For agents sending webhooks: create a project and app, publish events via the REST API, and Convoy handles delivery to all subscribed endpoints with retry logic and delivery status tracking. For agents receiving webhooks: use Convoy as an inbound webhook proxy that buffers and retries delivery to internal services. Competitive with Svix (SaaS-only) and Hookdeck (inbound focus). Self-hosted option is a key differentiator. Confidence is docs-derived.

API key auth: Authorization: Bearer {api_key} header. Project-level API keys from Convoy Dashboard → Settings. Multiple keys per project for environment separation. HTTPS enforced. Inbound webhook signature verification: Convoy generates HMAC signatures for outgoing webhooks; receiving endpoints verify using endpoint-specific signing secrets. No OAuth2. Convoy Cloud: key management via dashboard. Self-hosted: admin API for key management.

docs.getconvoy.io provides the full documentation: REST API reference, SDK guide (Node.js, Python, Go, PHP), getting started tutorial, self-hosting deployment guide, and fanout vs. outgoing vs. incoming webhook configuration guides. Documentation quality is good and actively maintained. Getting started: create a Convoy Cloud account (free tier) or self-host with Docker. SDKs available for multiple languages. Community support via Convoy Discord and GitHub. Open-source MIT license.