# listings_create

> Create a new property listing.

<!-- Source: https://docs.actuallycare.com/tools/listings/listings_create -->

Create a new property listing. Call immediately with whatever data the user provides. Do NOT ask for missing fields — the system shows an editable draft card where the user can fill in remaining details. WORKFLOW: 1) Use [`lookup_address`](/tools/utility/lookup_address) first to get verified address data with coordinates 2) Create the listing with property details 3) Optionally schedule open houses with [`create_open_house`](/tools/deadline/create_open_house). Returns the created listing with ID. Required fields: property_address and list_price. May trigger notifications if integrations are configured.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `property_address` | string | Yes | Full property address (required). Use [`lookup_address`](/tools/utility/lookup_address) first for verified data. |
| `display_address` | string | No | Display address if different (e.g., "123 Main St, Unit 4B"). |
| `city` | string | No | City. |
| `state` | string | No | State abbreviation (e.g., CA). |
| `zip_code` | string | No | ZIP code. |
| `county` | string | No | County name. |
| `latitude` | number | No | Latitude coordinate (from [`lookup_address`](/tools/utility/lookup_address)). |
| `longitude` | number | No | Longitude coordinate (from [`lookup_address`](/tools/utility/lookup_address)). |
| `list_price` | number | Yes | Listing price in dollars (required). · Min: 0 |
| `mls_number` | string | No | MLS number (RESO ListingId). |
| `bedrooms` | number | No | Number of bedrooms. · Min: 0 |
| `bathrooms` | number | No | Number of bathrooms (can be decimal for half baths). · Min: 0 |
| `square_feet` | number | No | Square footage (RESO LivingArea). · Min: 0 |
| `lot_size` | number | No | Lot size in square feet. |
| `year_built` | number | No | Year built. |
| `garage_spaces` | number | No | Number of garage spaces. |
| `stories` | number | No | Number of stories. |
| `property_type` | enum | No | Type of property (RESO PropertyType). · One of: `single_family`, `condo`, `townhouse`, `multi_family`, `land`, `commercial` |
| `property_sub_type` | string | No | RESO PropertySubType (e.g., Attached, Detached). |
| `listing_date` | string | No | Date listing goes active on MLS. (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `expiration_date` | string | No | Listing agreement expiration date — important for tracking. (Format: YYYY-MM-DD) · Format: Date (YYYY-MM-DD) |
| `listing_status` | enum | No | Initial listing status. · One of: `active`, `pending`, `coming_soon` |
| `description` | string | No | Property description (also sets public_remarks). |
| `public_remarks` | string | No | RESO PublicRemarks (MLS description). |
| `showing_instructions` | string | No | RESO ShowingInstructions. |
| `virtual_tour_link` | string | No | Virtual tour URL (branded). |
| `list_agent_mls_id` | string | No | RESO ListAgentMlsId. |
| `list_agent_full_name` | string | No | RESO ListAgentFullName. |
| `list_office_name` | string | No | RESO ListOfficeName. |

## Example prompts

- "Create a listing for 412 Birchwood Ln at 489,000, 4 bed 3 bath, 2,150 square feet."
- "List the Garcias' condo at 901 Marsh Creek Dr for 315,000 as coming soon."

## 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.

## Previous name

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