# rental_applications_convert_to_lease

> Atomically approve (if pending) and create a lease from an approved application.

<!-- Source: https://docs.actuallycare.com/tools/rental-applications/rental_applications_convert_to_lease -->

Atomically approve (if pending) and create a lease from an approved application. Links the new lease to the application via rental_application_id. The new lease automatically inherits the application's listing and brokerage/team assignment. Cannot convert denied or withdrawn applications. Returns the new lease record. This is the canonical "I've decided to sign this tenant" action.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `application_id` | string | Yes | UUID of the application to convert · Format: UUID |
| `lease_start` | string | Yes | Lease start date (ISO format, YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `lease_end` | string | Yes | Lease end date (ISO format, YYYY-MM-DD) (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `monthly_rent` | number | Yes | Monthly rent amount · Min: 0 |
| `security_deposit` | number | No | Security deposit amount · Min: 0 |
| `lease_type` | enum | No | Lease type (default: residential) · One of: `residential`, `commercial`, `short_term` |
| `landlord_contact_id` | string | No | UUID of the landlord contact · Format: UUID |
| `renter_client_id` | string | No | UUID of the renter client. If not provided, the agent should create a client with client_type=tenant first via [`clients_create`](/tools/clients/clients_create) and link it here. · Format: UUID |
| `commission_amount` | number | No | Agent commission for this lease · Min: 0 |
| `notes` | string | No | Lease notes · Max length: 10000 |

## Example prompts

- "Sign Tia Moreno as the tenant, twelve month lease at 2400 a month starting July 1."
- "Convert the approved Birchwood Ln application into a lease with a 2400 deposit."

## Safety

**Creates data.** Creates a new record in your CRM and may trigger notifications or webhooks. Running it twice creates a duplicate, so Claude runs it once per request.