Skip to main content

Documentation Index

Fetch the complete documentation index at: https://klipy.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

deal.closed

What this event means

deal.closed is emitted when a deal is closed with outcome won or lost. It combines internal close states into one outbound webhook type.

Webhook type

deal.closed

Internal source mapping

Internal eventsTrigger path
deal.closed_won, deal.closed_lostDeal moved into closed state (CLOSED_WON or CLOSED_LOST).

Payload example

{
  "type": "deal.closed",
  "object": "event",
  "data": {
    "actor_name": "Alex Morgan",
    "deal_id": "dl_1a2b3c",
    "pipeline_id": "pl_b4c5d6",
    "pipeline": "Q4 Pipeline",
    "cycle_length": 38,
    "days_diff_from_estimate": -2,
    "estimated_value": 18500,
    "currency": "USD",
    "deal_creation_date": "2026-03-13T09:21:11.122Z",
    "estimated_close_date": "2026-06-01T00:00:00.000Z",
    "is_private": false,
    "deal_name": "Acme Analytics - Expansion plan",
    "owner_name": "Alex Morgan",
    "from": "Qualified",
    "won": true,
    "company": {
      "name": "Acme Analytics",
      "domain": "acmeanalytics.com"
    },
    "point_of_contact": {
      "first_name": "Jordan",
      "last_name": "Patel",
      "email": "jordan.patel@acmeanalytics.com",
      "title": "Head of Growth"
    }
  }
}

Delivery and idempotency handling

  • Use data.deal_id for dedupe and as the immutable entity reference.
  • won indicates close outcome as derived from the current deal stage.
  • If your system needs closed-at timing, store your own timestamp when you first receive this event because delivery retries can occur.
Last modified on April 26, 2026