# leads_update

> Update an existing lead's information or status.

<!-- Source: https://docs.actuallycare.com/tools/leads/leads_update -->

Update an existing lead's information or status. Only provided fields are updated — omitted fields remain unchanged. Common uses: advance status as the lead warms up, correct contact details, or record the source. Returns the updated lead record.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `lead_id` | string | Yes | UUID of the lead to update · Format: UUID |
| `first_name` | string | No | Updated first name |
| `last_name` | string | No | Updated last name |
| `email` | string | No | Updated email |
| `phone` | string | No | Updated phone |
| `status` | enum | No | Updated status · One of: `new`, `contacted`, `qualified`, `unqualified`, `converted`, `lost` |
| `notes` | string | No | Notes to add |

## Example prompts

- "Mark Maria Garcia's lead as contacted and note that she wants a callback Friday."
- "Update Tom Nguyen's phone to 661-555-0198 and set his status to qualified."

## Safety

**Updates data.** Changes an existing record. The change is visible immediately in the app and can be edited back.

## Previous name

This tool was previously published as `update_lead`. Call it by its current name — legacy names are kept here for reference and old links redirect, but they are not callable.