# leads_convert

> Convert a lead to a client when they become an active buyer or seller.

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

Convert a lead to a client when they become an active buyer or seller. Use at the moment a representation agreement is signed or the lead commits to working with you. Returns the new client record linked to the original lead.

> [!WARNING]
> This is IRREVERSIBLE — once a lead is marked converted, the source/timeline data freezes for analytics.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `lead_id` | string | Yes | UUID of the lead to convert · Format: UUID |
| `client_type` | enum | No | Type of client they are becoming · One of: `buyer`, `seller`, `both` |

## Example prompts

- "The Garcias signed a buyer agreement, so convert their lead to a buyer client."
- "Convert Tom Nguyen to a seller client, but confirm with me first since it is irreversible."

## Safety

**Irreversible.** This action cannot be undone. Claude should always confirm with you before running it.

## Previous name

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