leads_update
Update properties of a lead in Pipedrive, including title, value, owner, or archive status. Only included fields are modified.
Instructions
Update an existing lead in Pipedrive.
Updates one or more properties of a lead. Only properties included in the request will be updated. Send null to unset a property (applicable for value, person_id, or organization_id).
Workflow tips:
Only include fields you want to update
Lead ID must be a UUID
Use null to clear optional fields
value must be an object with amount and currency
Leads inherit custom fields structure from deals
Set is_archived to true to archive a lead
Common use cases:
Update title: { "id": "", "title": "Updated Title" }
Update value: { "id": "", "value": { "amount": 10000, "currency": "USD" } }
Archive lead: { "id": "", "is_archived": true }
Clear person: { "id": "", "person_id": null }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | UUID of the lead to update (required) | |
| title | No | Lead title | |
| owner_id | No | ID of the user who will own this lead | |
| label_ids | No | Array of label UUIDs | |
| person_id | No | ID of the person associated with this lead (null to clear) | |
| organization_id | No | ID of the organization associated with this lead (null to clear) | |
| is_archived | No | Whether the lead is archived | |
| value | No | Lead value with amount and currency (null to clear) | |
| expected_close_date | No | Expected close date in YYYY-MM-DD format | |
| visible_to | No | Visibility level | |
| was_seen | No | Whether the lead was seen | |
| channel | No | Channel ID | |
| channel_id | No | Channel identifier string |