---
search:
  tags:
    - Webhooks
    - POST
    - Webhook
seo:
  description: >-
    Sent when a lead's status changes. Stored status completed is sent as won. A
    retry… Reference for the POST lead.status_changed webhook in the Comarketing
    API.
sidebar:
  label: lead.status_changed
  badge: POST
title: lead.status_changed
type: openapi-operation
---
Sent when a lead's status changes. Stored status `completed` is sent as `won`. A retry posts the same `id`.

`POST lead.status_changed`

**Webhook.** The API sends this request to your endpoint.

**Payload** (`application/json`, required)

- `id` (string, required)
- `type` (string, required)
- `leadId` (string, required)
- `agreementId` (string, required)
- `origin` (string, required)
- `status` (string, required)

Payload example:

```json
{
  "id": "evt_id",
  "type": "lead.status_changed",
  "leadId": "lead_id",
  "agreementId": "agr_id",
  "origin": "api",
  "status": "won"
}
```

**Responses**

- `200` — Any success status acknowledges the event. Other statuses are retried.