IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
  • Contacts and reports
  • Evaluations
  • Webhooks
  • More endpoints
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
Webhook events

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
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:

Webhook body
{
  "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

EventWhen
deal.createdA new deal was added, from the dashboard or the API.
deal.verdict_changedThe verdict on a deal changed. Has verdict and previousVerdict.
deal.chance_changedThe chance of success changed by one point or more. Has chanceOfSuccess (0 to 1) and the percent before and after.
deal.archivedA deal was archived. Has the reason, if one was given.
pipeline.stage_changedA deal moved to a different stage.
intake.submittedA founder sent an intake form.
meeting.vote_castA partner voted in a meeting.
kill_criteria.breachedA deal failed a kill criterion.
saved_search.net_newA 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.testA test event, sent when you select Test or call the test endpoint.
*All events.

Headers

HeaderValue
X-IdeaPulley-Signaturet=<unix time>,v1=<hex>. Use it to make sure that the request is from us.
X-IdeaPulley-EventThe event name.
X-IdeaPulley-DeliveryThe event ID. It is the same on each retry.
X-IdeaPulley-Attempt1 for the first try, then 2, 3 and so on.
X-IdeaPulley-TimestampThe unix time of this try.
X-Scout-SignatureThe same value as X-IdeaPulley-Signature, for older receivers.
X-Scout-Signature-LegacyOnly 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.

TypeScript
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));
}
Python
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.

IdeaPulleyDocs
GuidesAPI referenceOpenAPI
Open app
  • Introduction
Get started
  • Authentication
  • API basics
  • Errors
  • Rate limits
Endpoints
  • Fund
  • Deals
  • Memos
  • Notes
  • Decisions and outcomes
  • Contacts and reports
  • Evaluations
  • Webhooks
  • More endpoints
Guides
  • Application form
  • Webhook events
  • Claude and ChatGPT (MCP)
  • Zapier, n8n and Polytomic
Webhook events

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
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:

Webhook body
{
  "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

EventWhen
deal.createdA new deal was added, from the dashboard or the API.
deal.verdict_changedThe verdict on a deal changed. Has verdict and previousVerdict.
deal.chance_changedThe chance of success changed by one point or more. Has chanceOfSuccess (0 to 1) and the percent before and after.
deal.archivedA deal was archived. Has the reason, if one was given.
pipeline.stage_changedA deal moved to a different stage.
intake.submittedA founder sent an intake form.
meeting.vote_castA partner voted in a meeting.
kill_criteria.breachedA deal failed a kill criterion.
saved_search.net_newA 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.testA test event, sent when you select Test or call the test endpoint.
*All events.

Headers

HeaderValue
X-IdeaPulley-Signaturet=<unix time>,v1=<hex>. Use it to make sure that the request is from us.
X-IdeaPulley-EventThe event name.
X-IdeaPulley-DeliveryThe event ID. It is the same on each retry.
X-IdeaPulley-Attempt1 for the first try, then 2, 3 and so on.
X-IdeaPulley-TimestampThe unix time of this try.
X-Scout-SignatureThe same value as X-IdeaPulley-Signature, for older receivers.
X-Scout-Signature-LegacyOnly 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.

TypeScript
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));
}
Python
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.