Estimates

New to webhooks? Start with Getting started (envelope, delivery, retries) and Verification (confirming a request came from Grow CRM). Those conventions apply to every event below and are not repeated here.

Estimates expose all five keys: estimate.created, estimate.updated, estimate.deleted, estimate.sundry, estimate.activity.

The estimate object

Every key except .deleted carries this shape, either flat (.created) or nested under estimate (.updated/.sundry):

{
  "id": 118,
  "status": "draft",
  "client": { "id": 12, "name": "Acme Inc" },
  "project_id": null,
  "category": { "id": 4, "name": "Default" },
  "dates": { "date": "2026-07-16", "expiry_date": "2026-08-15", "created": "2026-07-16T08:00:00.000000Z" },
  "notes": null,
  "tax_type": "summary",
  "totals": {
    "subtotal": "250.00",
    "discount_type": "amount",
    "discount_amount": "25.00",
    "tax_total_amount": "22.50",
    "final_amount": "247.50"
  },
  "line_items": [
    { "id": 1, "description": "Item A", "unit": "hours", "quantity": "2.00", "rate": "100.00",
      "total": "200.00", "type": "plain", "tax_status": "taxable",
      "discount": { "type": "none", "value": "0.00", "amount": "0.00" } }
  ],
  "taxes": [ { "name": "VAT", "rate": "10.00" } ],
  "tags": ["priority"]
}

Field	Type	Notes
`id`	integer	`bill_estimateid`.
`status`	string	`draft`, `new`, `accepted`, `revised`, `declined`, or `expired` — the raw status value, no title/color object on this transformer (unlike invoices/tickets).
`client`	object	`{ id, name }`.
`project_id`	integer\|null
`category`	object	`{ id, name }`.
`dates`	object	`date`, `expiry_date` are raw dates (date only); `created` is ISO 8601 with microseconds (`Estimate` recasts `bill_created` via `CREATED_AT`).
`notes`	string\|null
`tax_type`	string	`summary`, `inline`, or `none`.
`totals`	object	`subtotal`, `discount_type` (`amount`, `percentage`, or `none`), `discount_amount`, `tax_total_amount`, `final_amount` — decimals as strings.
`line_items`	array	See the line item shape below.
`taxes`	array	`[{ name, rate }]`.
`tags`	array of strings

The line item shape

Shared with invoices:

Field	Type	Notes
`id`	integer	`lineitem_id`.
`description`	string
`unit`	string\|null
`quantity`	string	Decimal as string.
`rate`	string	Decimal as string.
`total`	string	Decimal as string.
`type`	string	`plain`, `time`, or `dimensions`.
`tax_status`	string	`taxable` or `exempt`.
`discount`	object	`{ type, value, amount }` — `type` is `none`, `fixed`, or `percentage`.

`estimate.created`

Fires when an estimate is created, including via clone. data is the full estimate object above.

{
  "event": "estimate.created",
  "id": 118,
  "created": "2026-07-16T08:00:00+00:00",
  "data": { "id": 118, "status": "draft", "client": { "id": 12, "name": "Acme Inc" }, "...": "..." }
}

`estimate.updated`

Fires on a significant change. data.change tells you which; data.estimate is the full object.

`change`	Fires when
`edited`	The main estimate edit form is saved.
`status`	The estimate’s status changes.
`accepted`	The client accepts the estimate.
`declined`	The client declines the estimate.
`published`	The estimate is published.
`sent`	The estimate email is (re)sent.
`converted`	The estimate is converted to an invoice. `data.estimate` still describes the estimate — check invoice webhooks for the new invoice.
`tax_type`	The tax type (summary/inline/none) is changed.
`automation`	The estimate’s automation settings are updated.
`project`	The estimate is attached to or detached from a project.

{
  "event": "estimate.updated",
  "id": 118,
  "created": "2026-07-16T08:05:00+00:00",
  "data": {
    "change": "accepted",
    "estimate": { "id": 118, "status": "accepted", "...": "..." }
  }
}

`estimate.sundry`

Fires on a minor, cosmetic field edit. data.field names it; data.estimate is the full object (same shape as .updated, just a lower-significance discriminator).

`field`	Fires when
`category`	The estimate’s category is changed.

{
  "event": "estimate.sundry",
  "id": 118,
  "created": "2026-07-16T08:07:00+00:00",
  "data": {
    "field": "category",
    "estimate": { "id": 118, "category": { "id": 4, "name": "Default" }, "...": "..." }
  }
}

`estimate.activity`

Fires when a child record on the estimate changes. Estimates only produce type: "attachment" — estimates are not part of core’s comment system.

`type`	`action`	Item shape
`attachment`	`added`	`{ id, uniqueid, filename }` — no `created` on this shape (unlike the `App\Models\Attachment`-backed resources).
`attachment`	`deleted`	`{ id, uniqueid, filename }` — the file record is looked up before it’s removed, so the full shape is still available.

{
  "event": "estimate.activity",
  "id": 118,
  "created": "2026-07-16T08:10:00+00:00",
  "data": {
    "type": "attachment",
    "action": "added",
    "item": { "id": 44, "uniqueid": "dg746287", "filename": "scope.pdf" }
  }
}

`estimate.deleted`

Fires after the estimate is deleted. data is just the id — the record no longer exists to describe.

{
  "event": "estimate.deleted",
  "id": 118,
  "created": "2026-07-16T08:15:00+00:00",
  "data": { "id": 118 }
}

Getting Started

Clients

Sales

Billing

Projects & Work

Support

Organisation

Estimates

Estimates

The estimate object

The line item shape

`estimate.created`

`estimate.updated`

`estimate.sundry`

`estimate.activity`

`estimate.deleted`

​Estimates

​The estimate object

​The line item shape

​estimate.created

​estimate.updated

​estimate.sundry

​estimate.activity

​estimate.deleted

Estimates

The estimate object

The line item shape

`estimate.created`

`estimate.updated`

`estimate.sundry`

`estimate.activity`

`estimate.deleted`