Expenses

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.

Expenses expose all five keys: expense.created, expense.updated, expense.deleted, expense.sundry, expense.activity.

The expense object

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

{
  "id": 214,
  "description": "AWS hosting — July",
  "date": "2026-07-16",
  "amount": "120.00",
  "billable": "billable",
  "billing_status": "not_invoiced",
  "category": { "id": 3, "name": "Hosting" },
  "client": { "id": 12, "name": "Acme Inc" },
  "project_id": 305,
  "dates": { "date": "2026-07-16", "created": "2026-07-16T08:00:00.000000Z" },
  "tags": []
}

Field	Type	Notes
`id`	integer	`expense_id`.
`description`	string\|null
`date`	string	Date only — duplicated in `dates.date` for convenience.
`amount`	string	Decimal as string.
`billable`	string	`billable` or `not_billable`.
`billing_status`	string	`invoiced` or `not_invoiced`.
`category`	object	`{ id, name }`.
`client`	object	`{ id, name }`.
`project_id`	integer\|null
`dates`	object	`date` is a raw date; `created` is ISO 8601 with microseconds (`Expense` recasts `expense_created` via `CREATED_AT`).
`tags`	array of strings

`expense.created`

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

{
  "event": "expense.created",
  "id": 214,
  "created": "2026-07-16T08:00:00+00:00",
  "data": {
    "id": 214,
    "description": "AWS hosting — July",
    "date": "2026-07-16",
    "amount": "120.00",
    "billable": "billable",
    "billing_status": "not_invoiced",
    "category": { "id": 3, "name": "Hosting" },
    "client": { "id": 12, "name": "Acme Inc" },
    "project_id": 305,
    "dates": { "date": "2026-07-16", "created": "2026-07-16T08:00:00.000000Z" },
    "tags": []
  }
}

`expense.updated`

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

`change`	Fires when
`edited`	The main expense edit form is saved.
`recurring`	The expense’s recurring settings are updated or stopped.
`project`	The expense is attached to a project.

{
  "event": "expense.updated",
  "id": 214,
  "created": "2026-07-16T08:05:00+00:00",
  "data": {
    "change": "project",
    "expense": { "id": 214, "project_id": 305, "...": "..." }
  }
}

`expense.sundry`

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

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

{
  "event": "expense.sundry",
  "id": 214,
  "created": "2026-07-16T08:07:00+00:00",
  "data": {
    "field": "category",
    "expense": { "id": 214, "category": { "id": 3, "name": "Hosting" }, "...": "..." }
  }
}

`expense.activity`

Fires when a child record on the expense changes. Expenses only produce type: "attachment".

`type`	`action`	Item shape
`attachment`	`added`	`{ id, uniqueid, filename, created }`
`attachment`	`deleted`	`{ id, uniqueid, filename, created }` — the attachment record is looked up before it’s removed, so the full shape is still available.

{
  "event": "expense.activity",
  "id": 214,
  "created": "2026-07-16T08:10:00+00:00",
  "data": {
    "type": "attachment",
    "action": "added",
    "item": { "id": 88, "uniqueid": "ryy388jf", "filename": "receipt.jpg", "created": "2026-07-16T08:10:00.000000Z" }
  }
}

`expense.deleted`

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

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

Getting Started

Clients

Sales

Billing

Projects & Work

Support

Organisation

Expenses

Expenses

The expense object

`expense.created`

`expense.updated`

`expense.sundry`

`expense.activity`

`expense.deleted`

​Expenses

​The expense object

​expense.created

​expense.updated

​expense.sundry

​expense.activity

​expense.deleted

Expenses

The expense object

`expense.created`

`expense.updated`

`expense.sundry`

`expense.activity`

`expense.deleted`