create_listing
Start a new property listing in YOUR agency's CRM from a description. Use when the agent is describing a property they have taken on and wants it in the system.
Creates a DRAFT. It is never published and never appears on the portal from here: the agent adds photographs and the energy rating in the CRM and publishes it themselves. The response includes a direct link to the draft.
Location is resolved against the real area tree, so a town, suburb or urbanisation name is enough. Requires an agency API key.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| price | No | Asking price in euros, or monthly rent for a rental. | |
| bedrooms | No | ||
| headline | No | Short headline for the listing. Optional. | |
| language | No | Language the description is written in. Defaults to the agency language. | |
| location | No | Town, suburb or urbanisation, e.g. "Nueva Andalucia" or "Menara Beach". | |
| plot_sqm | No | Plot size in square metres. | |
| bathrooms | No | ||
| build_sqm | No | Built area in square metres. | |
| description | Yes | The property description, in the language the agent wrote it. | |
| search_type | No | Whether it is for sale or for long-term rent. Defaults to for-sale. | |
| property_type | No | apartment, villa, penthouse, townhouse, plot or commercial. |