FounderTally
Webhooks
Get your reports and alerts as signed JSON in Zapier, Make, n8n or your own server.
In Settings → Integrations → Notifications, connect Webhook URL with the address your tool gives you (Zapier: Webhooks by Zapier → Catch Hook; Make: Custom webhook; n8n: Webhook node). FounderTally sends a signed test event to check it, then shows its signing secret once. Reports and alerts then arrive as JSON; Send test event sends one any time. One channel at a time: connecting a webhook replaces Slack, Discord or email.
{
"id": "evt_6f1c2a9b0d3e4f5a6b7c8d9e",
"type": "report",
"apiVersion": "v1",
"created": 1763193600,
"account": { "id": "a-3f9c1b2d4e5f6a7b" },
"data": {
"title": "Weekly report",
"text": "MRR $12,400, up 6% ...",
"link": { "label": "Open the report", "url": "https://foundertally.com/dashboard/business/weekly" }
}
}type is report, alert or test. Each request carries X-FounderTally-Event (the type), X-FounderTally-Delivery (the event id: drop a repeat) and X-FounderTally-Signature: t=<unix seconds>,v1=<hex>, the HMAC-SHA256 of <t>.<raw body> under your signing secret. Answer with a 2xx within 8 seconds. A timeout, a 429 or a 5xx is tried again, 3 tries in all, after 1 s and 4 s; redirects are not followed.
import { createHmac, timingSafeEqual } from "node:crypto";
// secret: the whsec_... value shown once when you connected the webhook.
export function verify(rawBody, header, secret, toleranceSeconds = 300) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const t = Number(parts.t);
if (!t || Math.abs(Date.now() / 1000 - t) > toleranceSeconds) return false;
const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
const given = Buffer.from(parts.v1 ?? "", "hex");
return given.length === 32 && timingSafeEqual(given, Buffer.from(expected, "hex"));
}import hashlib, hmac, time
def verify(raw_body: bytes, header: str, secret: str, tolerance: int = 300) -> bool:
parts = dict(p.split("=", 1) for p in header.split(","))
t = int(parts.get("t", "0"))
if abs(time.time() - t) > tolerance:
return False
expected = hmac.new(secret.encode(), f"{t}.".encode() + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, parts.get("v1", ""))Questions: support@foundertally.com