Ballmac UI home

Webhook Card

A webhook endpoint card with URL and enable switch, health from recent deliveries, a masked signing secret, subscribed events and expandable deliveries with payloads and redeliver.

https://api.example.com/hooks/billing
Active100% of 3 deliveries succeeded
Signing secretwhsec_••••••••••••••
Eventsinvoice.paidinvoice.failedcustomer.created+2 more

Recent deliveries

Installation

$ pnpm dlx shadcn@latest add @ballmac/webhook-card

Usage

import { WebhookCard } from "@/components/ballmac/webhook-card"

The full example is in the Code tab above.

Examples

Failing endpoint

https://hooks.shop.example.com/orders
Failing25% of 4 deliveries succeeded
Signing secretwhsec_••••••••••••••
Eventsorder.createdorder.paidorder.refunded

Recent deliveries

API reference

PropTypeDefault
url*

Endpoint URL that receives events.

string—
enabled

Whether deliveries are sent.

booleantrue
onEnabledChange

Called when the switch is flipped.

(enabled: boolean) => void—
secret

Signing secret. Masked until revealed.

string—
events

Events this endpoint subscribes to.

string[][]
visibleEvents

How many event names show before "+N".

number3
deliveries

Recent deliveries, newest first.

WebhookDelivery[][]
onRedeliver

Adds a Redeliver button to each opened delivery.

(delivery: WebhookDelivery) => void—
onTest

Adds a "Send test event" button.

() => void—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
SpaceToggles the endpoint
Enter / SpaceExpands a delivery
Screen readersEach status code reads with its meaning ('500, Server error'); payloads are labelled regions

Use with AI

url, enabled/onEnabledChange, secret, events, deliveries [{ id, event, status, duration, time, payload, response }], onRedeliver, onTest. Health is Active, Failing (half or more of the last five failed) or Disabled, shown with icon and word. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Webhook Card (@ballmac/webhook-card) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Developer dashboards that manage outgoing webhooks
  • Debugging failed deliveries

Not for

  • Incoming webhook documentation (api-endpoint)

Registry JSON: https://ui.ballmac.com/r/webhook-card.json

Credits

Free to use in personal and commercial projects.