---
updatedAt: 2026-07-28T12:59:22.000Z
agentTools:
  projectIndex: https://pipedrive.readme.io/llms.txt
---

# List of Webhooks v2

Every webhooks v2 subscription combines an **event action** (what happened) with one or more **event objects** (what it happened to). This page lists the values you can use for each.

<hr />

## Event actions

<hr />

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Event action
      </th>

      <th>
        API value
      </th>

      <th>
        Triggered when...
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **All**
      </td>

      <td>
        `*`
      </td>

      <td>
        ...any of the actions below happens.
      </td>
    </tr>

    <tr>
      <td>
        **Create**
      </td>

      <td>
        `create`
      </td>

      <td>
        ...a new object is added to your account.
      </td>
    </tr>

    <tr>
      <td>
        **Change**
      </td>

      <td>
        `change`
      </td>

      <td>
        ...any parameter of an existing object is updated. This covers every kind of edit, so moving a deal to another stage and renaming it both send a `change` notification.
      </td>
    </tr>

    <tr>
      <td>
        **Delete**
      </td>

      <td>
        `delete`
      </td>

      <td>
        ...an object is deleted.
      </td>
    </tr>
  </tbody>
</Table>

<hr />

## Event objects

<hr />

Any of these values can be paired with any event action.

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Event object
      </th>

      <th>
        API value
      </th>

      <th>
        Notifies you about
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **All**
      </td>

      <td>
        `*`
      </td>

      <td>
        Every object listed below
      </td>
    </tr>

    <tr>
      <td>
        Activity
      </td>

      <td>
        `activity`
      </td>

      <td>
        Activities
      </td>
    </tr>

    <tr>
      <td>
        Board
      </td>

      <td>
        `board`
      </td>

      <td>
        Project boards
      </td>
    </tr>

    <tr>
      <td>
        Deal
      </td>

      <td>
        `deal`
      </td>

      <td>
        Deals
      </td>
    </tr>

    <tr>
      <td>
        Deal field
      </td>

      <td>
        `deal_field`
      </td>

      <td>
        Deal field definitions
      </td>
    </tr>

    <tr>
      <td>
        Deal installment
      </td>

      <td>
        `deal_installment`
      </td>

      <td>
        Installments on a deal
      </td>
    </tr>

    <tr>
      <td>
        Deal product
      </td>

      <td>
        `deal_product`
      </td>

      <td>
        Products attached to a deal
      </td>
    </tr>

    <tr>
      <td>
        Lead
      </td>

      <td>
        `lead`
      </td>

      <td>
        Leads
      </td>
    </tr>

    <tr>
      <td>
        Lead field
      </td>

      <td>
        `lead_field`
      </td>

      <td>
        Lead field definitions
      </td>
    </tr>

    <tr>
      <td>
        Note
      </td>

      <td>
        `note`
      </td>

      <td>
        Notes
      </td>
    </tr>

    <tr>
      <td>
        Organization
      </td>

      <td>
        `organization`
      </td>

      <td>
        Organizations
      </td>
    </tr>

    <tr>
      <td>
        Organization field
      </td>

      <td>
        `organization_field`
      </td>

      <td>
        Organization field definitions
      </td>
    </tr>

    <tr>
      <td>
        Person
      </td>

      <td>
        `person`
      </td>

      <td>
        Persons
      </td>
    </tr>

    <tr>
      <td>
        Person field
      </td>

      <td>
        `person_field`
      </td>

      <td>
        Person field definitions
      </td>
    </tr>

    <tr>
      <td>
        Phase
      </td>

      <td>
        `phase`
      </td>

      <td>
        Phases within a project board
      </td>
    </tr>

    <tr>
      <td>
        Pipeline
      </td>

      <td>
        `pipeline`
      </td>

      <td>
        Pipelines
      </td>
    </tr>

    <tr>
      <td>
        Product
      </td>

      <td>
        `product`
      </td>

      <td>
        Products
      </td>
    </tr>

    <tr>
      <td>
        Product field
      </td>

      <td>
        `product_field`
      </td>

      <td>
        Product field definitions
      </td>
    </tr>

    <tr>
      <td>
        Project
      </td>

      <td>
        `project`
      </td>

      <td>
        Projects
      </td>
    </tr>

    <tr>
      <td>
        Project field
      </td>

      <td>
        `project_field`
      </td>

      <td>
        Project field definitions
      </td>
    </tr>

    <tr>
      <td>
        Stage
      </td>

      <td>
        `stage`
      </td>

      <td>
        Stages within a pipeline
      </td>
    </tr>

    <tr>
      <td>
        Task
      </td>

      <td>
        `task`
      </td>

      <td>
        Tasks within a project
      </td>
    </tr>

    <tr>
      <td>
        User
      </td>

      <td>
        `user`
      </td>

      <td>
        Users in your company
      </td>
    </tr>
  </tbody>
</Table>

<Callout icon="📘" theme="info">
  The `*_field` objects notify you about changes to **field definitions** — a field being added, renamed, or removed, or its options changing. To be notified when the *value* of a field on a record changes, subscribe to that record's object instead, such as `deal` or `person`.
</Callout>

To learn how to combine these values into a subscription, see the [guide for webhooks v2](https://pipedrive.readme.io/docs/guide-for-webhooks-v2).