Meta Lead Ads

Overview

Ruby connects to Meta's Lead Ads API via full OAuth. Connect once, pick which Facebook (and Instagram) business pages should capture leads, and every form submission flows into Ruby with every custom field you collected — name, phone, budget, area, whatever you asked for. If Meta drops a webhook, the manual catchup fetch pulls missed leads on demand.

How to set up

1. 1

   In Ruby, Settings → Integrations → Facebook → 'Connect Facebook'.

2. 2

   Sign in with the Meta account that admins your business pages and grant Ruby the leads_retrieval permission.

3. 3

   Pick which pages should capture leads — toggle each one on. Each page's form fields auto-map to Ruby's lead fields.

4. 4

   Future Lead Ads submissions appear in Ruby in seconds. Use 'Fetch leads' to manually pull catchup if Meta delays a webhook.

Benefits

• Real-time capture of every Facebook + Instagram Lead Ads submission
• All custom form fields preserved on the lead — not just name/phone
• Per-page on/off toggle — only the pages you choose pull leads
• Manual catchup fetch — pull missed leads on demand if Meta has a delivery delay
• Re-sync pages without re-authenticating — handles new pages added later

Why it matters

Meta ads are the cheapest source of mid-funnel buyer leads in the UAE — most brokerages run them but copy-paste leads from email or Meta Business Suite. Ruby's native integration eliminates the gap between ad spend and CRM, so attribution is honest and follow-ups happen before the lead's interest cools.