Whispyr logo
Back to the blog

Real Estate CRM

How Property Finder leads reach your CRM in Dubai

How a Property Finder enquiry, by call, email or WhatsApp, becomes a lead in your CRM: the Enterprise API key you create in PF Expert, the webhook, what to check in any CRM, and the exact setup in Whispyr AI, step by step. Checked 3 November 2026.

Nov 3, 20265 min read

Property Finder leads reach a CRM through Property Finder's Enterprise API. Someone with Decision Maker permissions on your PF Expert account creates an API key, the CRM uses it to subscribe to your lead events, and from then on Property Finder sends every new enquiry to the CRM as it happens. Calls, emails and WhatsApp enquiries all come through the same connection. In Whispyr AI the whole setup is one key pasted into Settings, and it takes 10 to 15 minutes.

This guide is written by Whispyr. The Whispyr steps come from Whispyr's own setup guide and code, checked on 3 November 2026. Property Finder's screens change from time to time; the steps stay the same.

How the connection works

  1. An API key. In PF Expert, under Developer Resources and then API Credentials, a Decision Maker creates a key with permission to read leads. Property Finder does not charge for Enterprise API access.
  2. A webhook. The CRM uses the key to tell Property Finder where to send new leads. Property Finder then pushes each enquiry to that address within seconds.
  3. The lead. The CRM turns the enquiry into a lead: the buyer's name and phone, the channel, and the listing the enquiry came from.

Two Property Finder lead events matter. A regular listing enquiry fires "lead created". Off-plan and Primary Plus project leads fire only "lead assigned". A CRM that listens to the first and not the second silently misses your project enquiries.

What to check in any CRM

Whichever CRM you use, ask it these questions before you trust it with your Property Finder budget:

  • Does it catch project leads? It should listen to both lead events above.
  • Does it handle every channel? Calls, emails and WhatsApp enquiries should all become leads.
  • What if a webhook is lost? Deliveries sometimes fail. A good CRM checks Property Finder on a schedule and pulls in anything it missed.
  • Does it merge repeat buyers? A buyer who enquires on three listings should be one person with three enquiries, not three contacts.
  • Who gets the lead? Your normal rotation, or the agent whose listing it was.
  • Can you see failures? An enquiry with no phone number cannot become a lead. You should still be able to see it.
  • Does it touch your listings? Some CRMs also publish listings to Property Finder. Know which one you are buying.

Setting it up in Whispyr

Before you start. You need a PF Expert account with Decision Maker permissions, room for one more API key (Property Finder allows 3 active keys at a time), and a Whispyr admin account. Property Finder leads arrive on Whispyr's Growth and Intelligence plans.

Step 1. Create the key in PF Expert.

  • Open Developer Resources, then API Credentials, and click New API Key.
  • Name it "Whispyr" and pick an expiry. Property Finder allows up to 365 days.
  • Under Scopes, set Leads to read. That one is required.
  • Set Users to read too if you want leads to go to the agent who owns the listing. Property Finder cannot add a scope to a key later, so include it if you are unsure.
  • Leave everything else at none. Whispyr does not read your listings, credits or statistics.
  • Agree to the API Access Terms, create the key, and copy the API Key and the API Secret.

Step 2. Paste it into Whispyr. Go to Settings, Integrations, Property Finder, paste the key and the secret, and click Connect. Before saving anything, Whispyr checks the key with Property Finder, confirms it can read leads, and subscribes itself to both lead events with its own signing secret. You never paste a callback address into Property Finder. The key and secret are stored encrypted, and there is no button to reveal them again.

Step 3. Choose who gets the leads.

  • Automatic assignment, the default: Property Finder leads follow the same rules as your Meta and API leads.
  • Honor the listing agent: each lead goes to the Whispyr user matched to the Property Finder agent who owns the listing. Whispyr suggests matches by email, and you confirm each one. An agent with no match falls back to automatic assignment, so no lead is dropped.

If your organization uses franchises, each franchise connects its own Property Finder key, and its leads land in that franchise.

What happens when a buyer enquires

Within seconds, the enquiry is a lead in Whispyr:

  • One person, many enquiries. A phone number Whispyr already knows is matched to the same person, and the enquiry is added to their record.
  • Context on the lead. A note shows the channel (call, email or WhatsApp), the enquiry type, the listing reference and the Property Finder agent.
  • A safety net. Every hour, Whispyr checks the last 6 hours of Property Finder leads and pulls in any the webhook never delivered. Each lead gets about six chances to arrive.
  • A log. Every delivery shows in Webhook logs. An enquiry with no phone number is shown as failed with the reason, and the raw enquiry is kept so you can follow up by hand.

When something stops working

  • The key expired or was disabled. Whispyr marks the connection "needs reconnect" and alerts every admin on it in the app, by email and by push. Create a new key and save it on the same card. Leads from the previous 6 hours are pulled in on the next sweep.
  • "Valid but no lead access". The key was made without the Leads read scope. Create a new one with it.
  • You are at 3 keys. Disable a key you no longer use in PF Expert.

What it does not do

  • Whispyr does not publish or edit your Property Finder listings, and it does not use your credits. The connection brings leads in only.
  • Status changes on Property Finder's side after the lead arrives, such as a call being answered later, are not copied onto the Whispyr lead.
  • Whispyr has no Bayut connector.

What it costs

Property Finder leads arrive on Growth and Intelligence. In the UAE, from Whispyr's price list on 3 November 2026: Growth is AED 12 a user a month, and Intelligence is AED 35, falling to AED 33 from 10 users, AED 31 from 20 and AED 28 from 60. Intelligence also includes a WhatsApp number for every seat, so the agent can answer the buyer on WhatsApp from the same lead.

Reading is one thing. Selling is another.