# Answer new Idealista Inbox contacts with an AI agent

> Unread Idealista contacts answered from the listing facts and your viewing slots; price talk and odd requests left for you, every thread noted.

Source: https://cotlet.dev/integrations/idealista-api-mcp-server/reply-to-contacts

Friday evening the Idealista Inbox fills with "is it still available?" and "can I see it this weekend?", and by Monday morning half of them have already booked a viewing somewhere else. Each one needs a short answer that matches the flat it is about.

Cotlet does it in your own Idealista account with list\_contacts, get\_conversation, get\_listing, reply\_to\_contact, send\_listings\_to\_contact and add\_contact\_note, called by your AI agent, an n8n workflow or a script.

[Request access](https://cotlet.dev/app/signup?app=idealista) [All Idealista tools](https://cotlet.dev/integrations/idealista-api-mcp-server)

Hosted · nothing to install or maintain

Official options

## Can Idealista do this on its own?

Idealista has no API for the Inbox (checked 12 Oct 2026), and its official Claude app only searches public listings without a login. Inside idealista/tools the help center describes reply templates (Plantillas), email alerts and push notifications from the idealista app, but each template is still picked and sent by hand, one contact at a time. We found no rule in the help center that answers new contacts on its own.

By hand

## How you do it in Idealista today

1. Open Inbox in idealista/tools: the Activas list shows every contact, and unread ones are marked in red with the number of unseen messages.
2. Narrow the Idealista Inbox with the filters for no vistas or no gestionadas, or type the street or reference of a property in the text search.
3. Click a contact to open the conversation, write the answer or pick one from Plantillas, edit it and press Enviar mensaje.
4. When the flat asked about does not fit, click the clip icon in the message box to attach other properties from your portfolio, a visit proposal or documents.
5. Contacts you dealt with by phone get Marcar como gestionado so the Idealista list stays honest. Every evening the same three questions come back for each listing, and a contact left unread over the weekend is the one that never replies.

With an agent

## How to answer new Idealista Inbox contacts with an AI agent

Prompt

```
Answer every unread Idealista contact about the Malasaña flat: offer Saturday 11:00 or 12:30 for a viewing, leave price questions for me, and note what you sent.
```

1. 01  
### Collect who is waiting  
The agent asks list\_contacts for unread contacts, narrowed to one listing when you name it. A contact whose last message came from you is left alone, since the next move is theirs.
2. 02  
### Read the thread before writing  
get\_conversation shows what was already said and your private notes. If a note says a viewing is booked, or a colleague answered by phone, the agent skips the contact instead of sending a second greeting.
3. 03  
### Answer only from facts it can check  
Rent, rooms, floor and features come from get\_listing, and viewing times come from your prompt. Questions about pets, deposits, discounts or documents that neither source answers are not guessed: those contacts go on a list for you.
4. 04  
### Offer alternatives when the flat does not fit  
When a contact asks about a listing that is already inactive, or names a budget under its price, the agent picks up to five of your active ads with the same operation and asks you before sharing them with send\_listings\_to\_contact.
5. 05  
### Leave a trace for the team  
After each sent reply, add\_contact\_note records what was offered and when, so the next person opening the conversation in Idealista sees it. Replies go out after your OK unless you switch confirmation off for reply\_to\_contact.

### What you get back

Example data

```
Malasaña flat (108274561): 6 unread contacts.
Answered 4 with Saturday 11:00 or 12:30 after your OK: Marta R., Jorge P., Elena V., Tom W. (in English).
Skipped Lucía G.: your note says she visits Friday at 18:00.
Left for you: Pablo S. asks if the rent drops to 1,350 EUR for a 2-year contract.
Notes added to 4 conversations.
```

### Other ways to ask

- Every evening at 20:00, answer new contacts on my rental listings with the Saturday viewing slots and leave anything about price for me.
- Every Monday, list last week's contacts per listing and the ones still without a reply after 24 hours.
- The Arroios room is rented: send everyone who asked about it our two other rooms in the same area, and ask me before sending.
- Answer in English to contacts who wrote in English and in Spanish to everyone else.

Before you automate it

## What Idealista allows, and what to know first

- The idealista/tools Inbox shows an Estadística de respuesta de 24h with your daily response rate, so contacts left unanswered overnight show up in that figure.
- Idealista Plantillas can be saved for all listings, for sale only or for rent only, and the idealista app chat offers the same templates.
- With Solo chat on, Idealista hides your phone number on rental homes and rooms and contacts can only write; only administrator and coordinator profiles can turn it on under Configuración > Gestión de contactos.
- Administrators and coordinators in idealista/tools can assign a contact to another agent from the Inbox list or from the conversation.
- Idealista cannot resend a contact message you deleted by mistake, and contacts write to you directly, without Idealista mediating, so a wrong phone or email means the person has to write again.

reply\_to\_contact and send\_listings\_to\_contact ask for your OK by default. To run it daily without you, switch confirmation off for those tools in your dashboard.

Sources: [idealista/tools help: Inbox](https://www.idealista.com/tools/centrodeayuda/articulos/inbox/) · [Idealista help: Problems with contacts received](https://www.idealista.com/ayuda/articulos/problems-with-contacts-received/?lang=en)

REST

## Call reply\_to\_contact from a script

curl

```
curl https://cotlet.dev/api/v1/idealista/reply_to_contact \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_id":"c_83920417","body":"Hi Marta, the flat is still available. I can show it on Saturday at 11:00 or 12:30. Which suits you?"}'
```

Example response

```
{
"contact_id": "c_83920417",
"message_id": "m_552019384",
"status": "sent",
"sent_at": "2026-10-10T18:42:00+02:00"
}
```

MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is idealista\_reply\_to\_contact. Example data.

[Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/idealista-api-mcp-server#automations)

Tools

## Idealista tools this automation uses

__Cotlet Idealista tools used to answer new Idealista Inbox contacts with an AI agent__
| Tool | Parameters |
| --------------------------- | --------------------------------- |
| list\_contacts | listing\_id, state, since, cursor |
| get\_conversation | contact\_id |
| get\_listing | listing\_id |
| reply\_to\_contact | contact\_id, body |
| send\_listings\_to\_contact | contact\_id, listing\_ids, body |
| add\_contact\_note | contact\_id, note |

[All 14 Idealista tools with descriptions](https://cotlet.dev/integrations/idealista-api-mcp-server#tools)

## Frequently asked questions

### Does it work without idealista/tools?

Yes for reading and answering contacts in a private advertiser account. Inbox features such as templates, assigning contacts to agents and the 24-hour response figure are described in the idealista/tools help center and belong to agency accounts.

## More Idealista automations

- [Find Idealista listings with visits but no contacts](https://cotlet.dev/integrations/idealista-api-mcp-server/listings-with-visits-but-no-contacts)
- [Lower an Idealista listing price with an AI agent](https://cotlet.dev/integrations/idealista-api-mcp-server/lower-listing-price)
- [Deactivate a rented Idealista listing and archive its contacts](https://cotlet.dev/integrations/idealista-api-mcp-server/deactivate-rented-listing)
- [Idealista API and MCP server: every tool](https://cotlet.dev/integrations/idealista-api-mcp-server)
- [All use cases](https://cotlet.dev/use-cases)

## Give your agent access to Idealista.

Free 7-day trial with 5,000 credits, no card needed. Cotlet is independent and not affiliated with Idealista.

[Request access](https://cotlet.dev/app/signup?app=idealista)