Send your Kovara notifications to your own systems: a signed webhook, a Slack channel or your account email. Set them up at Account → Notifications → Delivery channels.
A notification is anything that appears in your Kovara notification list: request updates, procurement steps, supplier responses, awards, market alerts (watchlists, saved searches, plan price alerts) and system updates. Each channel chooses the categories it receives, or every category, including categories added later.
Delivery
- Within about a minute of the notification being created.
- At least once. A retry carries the same delivery
id, so a receiver that stores the ids it has handled never acts twice. - Failures are retried after 1 minute, 5 minutes, 30 minutes, 2 hours and 8 hours. After the sixth attempt the delivery is marked failed and stays in the channel's history for 30 days.
- A channel whose deliveries fail 20 times in a row is turned off, and the page says why. Turning it back on does not resend what was missed while it was off.
410 Gone(and, for Slack,403or404) means the destination was removed: that delivery is not retried.- Redirects are not followed. Use the final URL.
- Webhooks are called only on public internet addresses. A host that resolves to a private, loopback, link-local or cloud-metadata address is refused at the moment of the call, so changing DNS later cannot point Kovara at an internal service.
- Send test on a channel sends one test delivery at once and shows the answer. A failed test is not retried.
Webhook request
POST /your/path HTTP/1.1
Content-Type: application/json
User-Agent: Kovara-Webhooks/1.0 (+https://www.kovaragrid.com/docs/notification-channels)
Kovara-Event: notification.created
Kovara-Delivery: 4f1c2a7e-…
Kovara-Attempt: 1
Kovara-Signature: t=1762862400,v1=5f2c…{
"id": "4f1c2a7e-…",
"type": "notification.created",
"created_at": "2026-11-11T12:00:00.000Z",
"attempt": 1,
"data": {
"notification_id": "9b2e…",
"category": "market",
"title": "H100 SXM price moved",
"body": "…",
"url": "https://www.kovaragrid.com/…",
"created_at": "2026-11-11T11:59:58Z"
}
}type is notification.created or test. In a test, notification_id and category are null. category is one of request, procurement, supplier, award, market and system. Answer with any 2xx within 10 seconds; the body of the answer is ignored.
Verifying the signature
Kovara-Signature is t=<unix seconds>,v1=<signature>, where the signature is the lowercase hex HMAC-SHA256 of the string <t>.<raw body>, keyed with the channel's signing secret (whsec_ followed by 64 hex characters). The secret is shown once, when the channel is created or the secret is rotated.
- Take the raw request body exactly as received, before any JSON parsing.
- Reject the request if
tis more than 300 seconds from your clock. - Compute the HMAC and compare it to
v1in constant time.
Node.js:
import { createHmac, timingSafeEqual } from "node:crypto";
export function verifyKovara(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(",").map(p => p.split("=")));
const t = Number(parts.t);
if (!Number.isInteger(t) || Math.abs(Date.now() / 1000 - t) > 300) return false;
const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest();
const given = Buffer.from(parts.v1 ?? "", "hex");
return given.length === expected.length && timingSafeEqual(given, expected);
}Python:
import hashlib, hmac, time
def verify_kovara(raw_body: bytes, header: str, secret: str) -> bool:
parts = dict(p.split("=", 1) for p in header.split(","))
try:
t = int(parts["t"])
except (KeyError, ValueError):
return False
if abs(time.time() - t) > 300:
return False
expected = hmac.new(secret.encode(), f"{t}.".encode() + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, parts.get("v1", ""))Slack
Create an incoming webhook in Slack (Apps → Incoming Webhooks → Add to a channel) and paste its URL, which starts with https://hooks.slack.com/services/. Each notification becomes one message with its title linked to Kovara. Titles and bodies are escaped, so they can never become links or mentions.
Email goes to the address of your Kovara account and to no other address. One email channel per person.
Limits
- 10 channels per person.
- One test per channel every 30 seconds.
- The full URL of a channel is never shown again after it is saved; the page shows its host and last characters.