Webhook events
A webhook sends a signed POST to your server when something changes in your fund. Use it to keep your CRM, your data warehouse or a Slack channel up to date without polling.
Add a webhook
Add one in IdeaPulley under Settings → Automations, or with the API. The key needs the webhooks:manage scope. Leave out events to get all events. You get the signing secret one time only, in the response.
curl -X POST https://www.ideapulley.com/api/v2/webhooks \
-H "Authorization: Bearer $IDEAPULLEY_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/hooks/ideapulley","events":["deal.created","deal.chance_changed"]}'All webhook endpoints are in the Webhooks API.
Payload
Each delivery is a POST with a JSON body like this:
{
"id": "evt_…",
"event": "deal.chance_changed",
"createdAt": "2026-10-30T12:00:00.000Z",
"orgId": 42,
"data": {
"dealId": 101,
"companyName": "Acme Robotics",
"chanceOfSuccess": 0.12,
"chanceOfSuccessPercent": 12,
"previousChanceOfSuccessPercent": 9
}
}Events
| Event | When |
|---|---|
deal.created | A new deal was added, from the dashboard or the API. |
deal.verdict_changed | The verdict on a deal changed. Has verdict and previousVerdict. |
deal.chance_changed | The chance of success changed by one point or more. Has chanceOfSuccess (0 to 1) and the percent before and after. |
deal.archived | A deal was archived. Has the reason, if one was given. |
pipeline.stage_changed | A deal moved to a different stage. |
intake.submitted | A founder sent an intake form. |
meeting.vote_cast | A partner voted in a meeting. |
kill_criteria.breached | A deal failed a kill criterion. |
saved_search.net_new | A saved search with its alert on found companies added since its last check. Has savedSearchId, name, since, until and companies (dealId, companyName, createdAt, link). Sent once per check that finds something. |
webhook.test | A test event, sent when you select Test or call the test endpoint. |
* | All events. |
Headers
| Header | Value |
|---|---|
X-IdeaPulley-Signature | t=<unix time>,v1=<hex>. Use it to make sure that the request is from us. |
X-IdeaPulley-Event | The event name. |
X-IdeaPulley-Delivery | The event ID. It is the same on each retry. |
X-IdeaPulley-Attempt | 1 for the first try, then 2, 3 and so on. |
X-IdeaPulley-Timestamp | The unix time of this try. |
X-Scout-Signature | The same value as X-IdeaPulley-Signature, for older receivers. |
X-Scout-Signature-Legacy | Only on webhooks made before signing secrets. It is not safe. Make the webhook again to get a secret. |
Verify the signature
v1 is the HMAC-SHA256 of t + "." + raw body, with your signing secret as the key. Calculate it on the raw body, before you parse the JSON. Compare in constant time. Reject the request if the signature is wrong, or if t is more than 5 minutes from your clock.
import { createHmac, timingSafeEqual } from "node:crypto";
const TOLERANCE_SECONDS = 300;
// header: the X-IdeaPulley-Signature value, t=<unix>,v1=<hex>
// rawBody: the body as text, before you parse the JSON
export function verify(secret: string, header: string, rawBody: string): boolean {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=", 2)));
const t = Number(parts.t);
if (!Number.isInteger(t)) return false;
// Reject old deliveries: this stops replays.
if (Math.abs(Date.now() / 1000 - t) > TOLERANCE_SECONDS) return false;
const want = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
const got = String(parts.v1 ?? "");
return got.length === want.length && timingSafeEqual(Buffer.from(want), Buffer.from(got));
}import hashlib, hmac, time
TOLERANCE_SECONDS = 300
def verify(secret: str, header: str, raw_body: bytes) -> bool:
# header is the X-IdeaPulley-Signature value: t=<unix>,v1=<hex>
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
try:
t = int(parts["t"])
except (KeyError, ValueError):
return False
# Reject old deliveries: this stops replays.
if abs(time.time() - t) > TOLERANCE_SECONDS:
return False
message = str(t).encode() + b"." + raw_body
want = hmac.new(secret.encode(), message, hashlib.sha256).hexdigest()
return hmac.compare_digest(want, parts.get("v1", ""))Retries
Reply with a 2xx status in 10 seconds. If there is no answer, or the answer is a 429 or a 5xx, we send it again after 1 minute, 5 minutes, 15 minutes and 1 hour: five tries in all. Other 4xx answers are not sent again. Use the event ID to ignore a duplicate.
The delivery log is in Settings → Automations, and at GET /webhooks/{id}/deliveries.