Endpoint list
Webhook endpoints: URL, events, status, a switch, a test button and the signing secret.
import { EndpointList } from "@forgeron/ui";https://example.test/hooks/billingActivePushes paid invoices to the ledger.
invoice.paidinvoice.sentinvoice.latepayment.refunded+1Last delivery today
Signing secretSetChanged 48 days ago••••••••••••https://example.test/hooks/chatFailingmember.joinedLast delivery yesterday
Signing secretSetChanged 68 days ago••••••••••••https://example.test/hooks/archiveDisableddocument.deletedSigning secretNot setNothing stored yet.
import { EndpointList, type EndpointTestResult, type WebhookEndpoint } from "@forgeron/ui";
import { useState } from "react";
const endpoints: WebhookEndpoint[] = [
{
id: "e1",
name: "Billing sync",
url: "https://example.test/hooks/billing",
description: "Pushes paid invoices to the ledger.",
events: [
"invoice.paid",
"invoice.sent",
"invoice.late",
"payment.refunded",
"customer.updated",
],
status: "active",
lastDeliveryAt: "2026-11-19 09:41",
secret: { isSet: true, rotatedAt: "2026-10-02" },
},
{
id: "e2",
name: "Chat alerts",
url: "https://example.test/hooks/chat",
events: ["member.joined"],
status: "failing",
lastDeliveryAt: "2026-11-18 22:03",
secret: { isSet: true, rotatedAt: "2026-09-12" },
},
{
id: "e3",
url: "https://example.test/hooks/archive",
events: ["document.deleted"],
status: "disabled",
secret: { isSet: false },
},
];
export default function Default() {
const [list, setList] = useState(endpoints);
const [testing, setTesting] = useState<string[]>([]);
const [results, setResults] = useState<Record<string, EndpointTestResult>>({});
return (
<div style={{ width: "100%", maxWidth: 720 }}>
<EndpointList
endpoints={list}
today="2026-11-19"
testing={testing}
testResults={results}
getSecret={() => "fg_test_xxxxxxxx"}
onReplaceSecret={() => {}}
onSelect={() => {}}
onToggle={(id, enabled) =>
setList(
list.map((e) => (e.id === id ? { ...e, status: enabled ? "active" : "disabled" } : e)),
)
}
onTest={(id) => {
setTesting([...testing, id]);
setTimeout(() => {
setTesting((t) => t.filter((x) => x !== id));
setResults((r) => ({
...r,
[id]:
id === "e2"
? { ok: false, code: 503, message: "Service unavailable" }
: { ok: true, code: 200 },
}));
}, 800);
}}
/>
</div>
);
}API → Props
| Prop | Type | Default | Description |
|---|---|---|---|
endpoints | { id, url, name?, description?, events, status, lastDeliveryAt?, secret?: { isSet, rotatedAt? } }[] | — | status: active, disabled, failing. |
onToggle | (id, enabled) => void | — | The switch. |
onTest / testing / testResults | (id) => void; string[]; Record<id, { ok, code?, message? }> | — | Send a sample event; which are on their way; how the last went. |
onSelect | (id) => void | — | Deliveries: open the log of an endpoint. |
getSecret / onReplaceSecret | (id) => string | Promise<string>; (id, value) => void | — | For the SecretField of each endpoint. |
today | string | — | YYYY-MM-DD: dates are told from it (“3 days ago”, “In 5 days”). |
className | string | — | Extra classes. |