---
title: "contact.stage_changed — Customer stage changed"
locale: en
url: https://tlg.builera.app/en/docs/reference/events/contact.stage_changed
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# contact.stage_changed — Customer stage changed

The customer moved to another stage of the sales pipeline.

The customer moved to another stage of the sales pipeline.

Since web 1.0.0, worker —.

| Name | Value |
| --- | --- |
| Code | `contact.stage_changed` |
| Group | People (CRM) |
| Status | Subscribable |
| Scope needed to receive it | `crm.read` |
| Tied to one account | No |
| Only the connection that caused it receives it | No |
| Filters that apply | `person_stage_ids` |
| Fields dropped in `thin` content mode | `person.name`, `person.username`, `reason` |
| Fields written by outside people (untrusted) | `person.name` |

## JSON Schema

[https://tlg.builera.app/schemas/events/contact.stage_changed/2.json](https://tlg.builera.app/schemas/events/contact.stage_changed/2.json)

## Sample payload (exactly what `webhooks.test` sends)

```json
{
  "specversion": "1.0",
  "id": "evt_01JDOCSSAMPLE",
  "source": "https://tlg.builera.app/ws/07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "type": "contact.stage_changed",
  "time": "2026-10-21T13:45:00.123Z",
  "datacontenttype": "application/json",
  "dataschema": "https://tlg.builera.app/schemas/events/contact.stage_changed/2.json",
  "platform": "telegram",
  "workspaceid": "07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "accountid": null,
  "seq": "000000000000000",
  "schemaversion": "2",
  "correlationid": null,
  "causationid": null,
  "test": true,
  "replay": false,
  "data": {
    "person": {
      "id": "c41b7e2a-9d3c-4b1f-8e2a-7c5d3b1f9e08",
      "name": "Nguyễn Văn A",
      "username": "nva",
      "tg_user_id": "456789",
      "stage_id": "3e5f7a9b-1c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "tags": [
        "vip"
      ],
      "temperature": "warm",
      "owner_account_id": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
      "listed": true
    },
    "from_stage": {
      "id": "2d3e4f5a-6b7c-4d8e-9f0a-1b2c3d4e5f6a",
      "name": "Đã trả lời",
      "key": "replied"
    },
    "to_stage": {
      "id": "3e5f7a9b-1c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "name": "Quan tâm",
      "key": "interested"
    },
    "by": {
      "kind": "human",
      "id": null
    },
    "reason": null,
    "untrusted_fields": [
      "person.name"
    ]
  }
}
```