---
title: "Update a lead"
method: PATCH
path: "/leads/{id}"
tags: ["Leads"]
---

# Update a lead

`PATCH /leads/{id}`

Updates an existing lead in your CRM. Only provided fields will be updated.

## Path parameters

- `id` string, required — Lead public ID

## Request body

- object
  - `name` string — Lead's full name
  - `mobile` string — Mobile phone number with country code
  - `secondaryMobile` string — Secondary mobile phone number with country code
  - `email` string, email, nullable
  - `title` string — Job title or position
  - `value` number — Expected deal value or amount
  - `sourceId` string — Lead source public ID
  - `stageId` string — Lead stage public ID
  - `website` unknown

## Response `200`

OK

- object
  - `id` string, required — Lead public ID
  - `number` string, required — Auto-generated lead number
  - `name` string, required — Full name
  - `title` string, nullable — Job title
  - `email` string, nullable — Email address
  - `mobile` string, nullable — Mobile phone number
  - `secondaryMobile` string, nullable — Secondary mobile
  - `website` string, nullable — Website URL
  - `value` number, nullable — Expected value
  - `archived` boolean, required — Whether the lead is archived
  - `sourceId` string, nullable — Lead source public ID
  - `stageId` string, nullable — Lead stage public ID
  - `createdAt` string, date-time, required — When the lead was created
  - `customFields` object, nullable — Custom field values

---

[API](https://skmtc.net/heffl/apis/heffl-api-v2-beta.md) · [All operations](https://skmtc.net/heffl/apis/heffl-api-v2-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/heffl/heffl-api-v2-beta/revisions/27006cfef4d8/schema)