---
name: bijection-webhook-sender
description: "Evaluate and integrate the Webhook Sender component with Bijection."
---

# Webhook Sender

Outbound signed webhooks

- Package: @bijectionhq/webhook-sender
- Category: Messaging
- Status: Preview
- License: MIT
- Bijection source (repository access required): https://github.com/bijectionhq/webhook-sender/tree/872d4ed78b85dd9ecec12b05823e0722fefbe437
- Upstream: https://github.com/TimpiaAI/convex-webhook-sender/tree/ebceea551dbe539145470fae0ed757d83ccaa0f1
- Documentation: https://docs.bijection.com/components/using
- Directory: https://bijection.com/components/webhook-sender

## Get the source

Bijection repository access is required. Request access at https://bijection.com/contact.

```sh
git clone https://github.com/bijectionhq/webhook-sender.git
cd webhook-sender
git checkout 872d4ed78b85dd9ecec12b05823e0722fefbe437
```

## Before using this component

Read the package README at the recorded revision for setup, dependencies, and API examples. Upstream documentation describes the original package and may differ from the Bijection adaptation. This is a source candidate for evaluation. Catalog inclusion does not establish npm availability or runtime qualification. Check compatibility with your SDK and deployment before adoption. External providers run their own compute.

## Integration workflow

1. Read the source README and package manifest at the recorded revision.
2. Confirm the required SDK, dependency availability, and runtime compatibility.
3. Follow the component's documented setup and configuration. Never invent an npm install command from a catalog package name.
4. Keep credentials in the project's existing secret store.
5. Follow the project's execution rules for verification and report what was actually checked.

## Original upstream skill

The following guidance describes convex-webhook-sender. Its installation commands and APIs refer to the upstream package. Evaluate compatibility with the Bijection source separately.


# Webhook Sender

## Instructions

Use Webhook Sender to convex component for reliable webhook delivery with ed25519 signing, automatic retries, exponential backoff, and complete delivery tracking. This Convex component integrates directly with your backend.

### Installation

```bash
npm install convex-webhook-sender
```

### Capabilities

- Eliminates webhook infrastructure development with built-in signing, retries, and delivery tracking
- Reduces webhook failures through automatic retry logic with exponential backoff and rate limiting
- Provides complete delivery visibility with attempt history, status codes, and error tracking
- Ensures webhook security with Ed25519 signing and included signature verification utilities

## Examples

### how to send webhooks from Convex mutations

The convex-webhook-sender component lets you send webhooks directly from Convex mutations using webhooks.send(). Register webhook destinations with webhooks.registerDestination() and the component handles HMAC signing, retries, and delivery tracking automatically.

### webhook retry logic Convex

The convex-webhook-sender component provides automatic retry logic with exponential backoff for 5xx responses and network failures. Configure maxRetries and retryWindowMs per destination to control retry behavior without building custom retry infrastructure.

### HMAC webhook signing Convex

The component automatically signs webhooks using HMAC-SHA256 with Standard Webhooks compatible secrets. It includes signature verification utilities for recipients and exposes signing secrets through getSigningSecret() for webhook validation.

### webhook delivery tracking Convex

Track webhook delivery status with getWebhookStatus() and view complete attempt history using getDeliveryHistory(). The component logs all delivery attempts including status codes, timestamps, and error details for debugging failed webhooks.

## When NOT to use

- When a simpler built-in solution exists for your specific use case
- If you are not using Convex as your backend
- When the functionality provided by Webhook Sender is not needed

## Troubleshooting

**How does convex-webhook-sender handle webhook signing?**

The convex-webhook-sender component uses HMAC-SHA256 signing with Standard Webhooks compatible secrets prefixed with 'whsec_'. It automatically adds webhook-signature headers and includes verification utilities for recipients to validate webhook authenticity.

**What retry logic does this webhook component provide?**

The component automatically retries webhooks on 5xx status codes and network failures using exponential backoff. You can configure maxRetries and retryWindowMs per destination, with parallel or serialized (FIFO) delivery modes available.

**Can I track webhook delivery status and failures?**

Yes, convex-webhook-sender provides complete delivery tracking through getWebhookStatus(), getDeliveryHistory(), and getFailedWebhooks() methods. The component logs all delivery attempts with status codes, timestamps, and error details for comprehensive monitoring.

**Does this component support rate limiting for webhooks?**

The convex-webhook-sender component includes per-destination rate limiting with configurable requests per second. This prevents overwhelming webhook endpoints while maintaining reliable delivery through the built-in retry mechanism.

## Resources

- [npm package](https://www.npmjs.com/package/convex-webhook-sender)
- [GitHub repository](https://github.com/TimpiaAI/convex-webhook-sender)
- [Live demo](https://webhook-sender-demo.vercel.app)
- [Convex Components Directory](https://www.convex.dev/components/convex-webhook-sender)
- [Convex documentation](https://docs.convex.dev)