# leads

> Lead Ads leads: list, qualify, convert into a WhatsApp chat.

Lead Ads leads: list, qualify, convert into a WhatsApp chat.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/leads` | `leads_list`: List leads | `leads:read` | - |
| GET | `/v1/leads/{lead_id}` | `leads_get`: Get a lead | `leads:read` | - |
| PATCH | `/v1/leads/{lead_id}` | `leads_update`: Update status, owner or notes | `leads:write` | - |
| POST | `/v1/leads/{lead_id}/convert` | `leads_convert`: Create or merge the contact and open a WhatsApp chat (template message) | `leads:write` | - |
| POST | `/v1/leads/sync` | `leads_sync`: Backfill leads for a form (reads Meta in bulk) | `leads:write` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
