Contracts

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.

Contracts expose four keys: contract.created, contract.updated, contract.deleted, contract.sundry. There is no contract.activity — contracts have no comments, attachments, or logs in core.

The contract object

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

{
  "id": 33,
  "title": "Website Redesign Contract",
  "status": "draft",
  "value": "5000.00",
  "client": { "id": 12, "name": "Acme Inc" },
  "category": { "id": 1, "name": "Default" },
  "project_id": null,
  "dates": {
    "start": "2026-07-16",
    "end": "2027-07-16",
    "created": "2026-07-16T08:00:00.000000Z",
    "published": null
  },
  "signing": { "client_status": "unsigned", "provider_status": "unsigned" },
  "tags": []
}

Field	Type	Notes
`id`	integer	`doc_id`.
`title`	string
`status`	string	`draft`, `awaiting_signatures`, `active`, or `expired` — the raw status value, no title/color object on this transformer.
`value`	string	Decimal as string.
`client`	object	`{ id, name }`.
`category`	object	`{ id, name }`.
`project_id`	integer\|null
`dates`	object	`start`, `end`, `published` are raw dates (date only); `created` is ISO 8601 with microseconds (`Contract` recasts `doc_created` via `CREATED_AT`).
`signing`	object	`client_status`, `provider_status` — each the raw signature status string for that side.
`tags`	array of strings

`contract.created`

Fires when a contract is created, including via clone. data is the full contract object above.

{
  "event": "contract.created",
  "id": 33,
  "created": "2026-07-16T08:00:00+00:00",
  "data": { "id": 33, "title": "Website Redesign Contract", "status": "draft", "...": "..." }
}

`contract.updated`

Fires on a significant change. data.change tells you which; data.contract is the full object. There is no edited change for contracts — core has no ContractUpdated event.

`change`	Fires when
`status`	The contract’s status changes.
`published`	The contract is published.
`sent`	The contract email is (re)sent.
`signed`	The client signs the contract.
`team_signed`	The provider/team side signs the contract.
`signature_removed`	A signature is removed from the contract.
`automation`	The contract’s automation settings are updated.
`project`	The contract is attached to or detached from a project.

{
  "event": "contract.updated",
  "id": 33,
  "created": "2026-07-16T08:05:00+00:00",
  "data": {
    "change": "signed",
    "contract": { "id": 33, "signing": { "client_status": "signed", "provider_status": "unsigned" }, "...": "..." }
  }
}

`contract.sundry`

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

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

{
  "event": "contract.sundry",
  "id": 33,
  "created": "2026-07-16T08:07:00+00:00",
  "data": {
    "field": "category",
    "contract": { "id": 33, "category": { "id": 2, "name": "Legal" }, "...": "..." }
  }
}

`contract.deleted`

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

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

Getting Started

Clients

Sales

Billing

Projects & Work

Support

Organisation

Contracts

Contracts

The contract object

`contract.created`

`contract.updated`

`contract.sundry`

`contract.deleted`

​Contracts

​The contract object

​contract.created

​contract.updated

​contract.sundry

​contract.deleted

Contracts

The contract object

`contract.created`

`contract.updated`

`contract.sundry`

`contract.deleted`