> ## Documentation Index > Fetch the complete documentation index at: https://docs.voqo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Eagle MRI Setup > Connect Eagle MRI to bring your full contact list into Voqo AI, kept in sync automatically. Eagle MRI is one of Australia's most widely used real estate CRMs. Connecting it brings your **full contact list** into Voqo — active enquiries, dormant enquirers, vendors, and everyone in between — so your AI voice agent has the complete picture to work from. Once connected, Voqo keeps itself in step with Eagle automatically — your contacts refresh **twice a day at 12pm and 6pm AEDT**, with no manual exports or uploads. **Listings sync for Eagle MRI is coming soon.** Today, Eagle connects for **contacts sync**. To register interest in Eagle listings sync, contact [adam@voqo.ai](mailto:adam@voqo.ai). ## Prerequisites * **Workspace admin** role (required to manage integrations) * An Eagle MRI account with permission to generate API credentials * Both your Eagle **client ID** and **client secret** ready to paste ### Where to find your Eagle credentials 1. Log in to Eagle at [eagleagent.com.au/agent](https://www.eagleagent.com.au/agent). 2. Go to **Settings**. 3. Open **API Credentials**. 4. Click **New Credentials**. 5. Copy both the **client ID** and the **client secret** — you'll need both. Keep this window open until you've pasted them into Voqo. Both values are required. The client ID on its own won't authenticate — Eagle needs the pair. ## Connect Eagle MRI The connect flow is a three-step wizard. Step 1 verifies your credentials, Step 2 enables contacts sync, and Step 3 previews how many records will come in so you can confirm before kicking off the sync. ### Step 1 — Credentials and test connection 1. Go to **Integrations** in the sidebar. 2. Find the **Eagle MRI** card and click **Connect**. 3. Paste your **Client ID** and **Client Secret** into the matching fields. 4. Click **Test connection**. If your credentials are valid, Voqo will tick the connection and move you to Step 2. If not, you'll see an error — double-check both values, then re-paste and test again. ### Step 2 — Enable contacts sync You'll see two scope options: * **Contacts** — tick this to bring your Eagle contacts into Voqo. This is required to connect. * **Listings** — **coming soon**, shown disabled. Your active stock, sold/leased/off-market history, and pre-market listings aren't available yet. To register interest, contact [adam@voqo.ai](mailto:adam@voqo.ai). When you tick **Contacts**, an optional limit field appears: > **Initial backfill limit (optional)** Most agencies leave this **blank** to bring in their full contact list — that's the recommended path. The limit field is there for two cases: * **Sanity-check the integration first.** Set a small number (e.g. 100) to see exactly what comes through before committing to a full backfill. Once you're happy, switch to **Sync all contacts** in **⋮ Settings** and hit **Resync** to bring in everyone. * **Very large tenants who want a phased rollout.** Cap the first import at, say, 5,000 and bring the rest in later from **⋮ Settings**. **When the limit is set, Voqo enters "test mode" for contacts.** The initial backfill brings in your **least recently updated** contacts (the dormant tail — they don't matter operationally, so they're safe to sample with), and the twice-daily delta sync is **paused** until you reconnect without a limit. To go live with ongoing contact sync, open the **⋮ Settings** on the Eagle MRI card, select **Sync all contacts** and **Save**, then click **Resync** to bring in your full contact list. There's no need to disconnect — your existing contacts are preserved. With **Contacts** ticked, click **Preview** to move to Step 3 and confirm before any sync starts. ### Step 3 — Preview and confirm This is a dry-run preview — nothing has been committed yet. You'll see: * The **total number of contacts** in your Eagle tenant (e.g. "84,105 contacts") * An **estimated sync time** based on Eagle's API throughput — if you set a limit, the estimate covers the limit, not the full count * A reassurance that you can close the modal and let it run in the background You have two choices: * **Adjust** — go back to Step 2 to set or change the initial-backfill limit. The preview re-runs when you return. * **Confirm and start sync** — commits the integration and kicks off the **contacts** sync job in the background. The modal closes immediately. ## What happens after you connect Contacts run as a background job — for a tenant of 80,000 contacts, expect around 10 minutes for the initial backfill. You can keep working while the sync runs. The **Eagle MRI** card on the Integrations page shows a **Connecting** status badge while the sync job is in progress. Once it completes, the badge flips to **Connected**. To watch progress in detail, open the **Sync History** panel (see below). ## Sync History The **Sync History** button lives at the top right of the **Integrations** page. Click it to slide open a panel showing every sync job across all your integrations. For each job you'll see: * **Provider** — Eagle MRI, VaultRE, Domain, etc. * **Scope** — Contacts * **Status** — Pending, Processing, Completed, or Failed * **Counts** — records created, updated, and skipped * **Estimated vs actual time** — so you can see whether the sync is on track * **Auto or Manual** — whether the job was kicked off by the scheduled twice-daily sync (**Auto**) or by you clicking **Sync now** or **Confirm and start sync** (**Manual**) Active jobs sit at the top of the panel with a live spinner. Failed jobs show a short error message and a **Retry** button. ## Ongoing sync After the initial backfill is complete, Voqo runs a delta sync **twice a day at 12pm and 6pm AEDT**. This pulls anything that has changed in Eagle since the last successful sync — including: * Updates to contacts you've already brought into Voqo * **New contacts** created in Eagle after you connected No action is required from you — these scheduled syncs are fully automatic. You'll see them appear as **Auto** rows in **Sync History**. If you want to pull updates between scheduled runs, click **Sync now** on the Eagle card. ## CSV import (coming in v1.1) If you've connected VaultRE or another CRM via CSV before, you might be looking for the same path with Eagle. CSV upload for Eagle is **coming in v1.1**. For now, the **API connection on the Integrations page is the only path** — and it's the recommended one anyway, because it handles initial backfill **and** keeps your contacts in step with Eagle automatically going forward. If you visit the **CSV Import** tab on the Contacts page and select **Eagle Agent (MRI)** as the source, you'll see a notice pointing you back here. ## Listing states from Eagle MRI (coming soon) **Listings sync for Eagle MRI isn't available yet.** The section below previews what Eagle listings sync will offer once it ships. To register interest, contact [adam@voqo.ai](mailto:adam@voqo.ai). When live, Eagle MRI exposes listings across multiple lifecycle states. Voqo will bring each into a dedicated tab in your Knowledge Base when you opt in. Once listings ship, you'll be able to choose how far back to keep sold and leased history (a **Historical listing window** selector), and turning a listing scope off will remove the matching listings after a confirmation prompt — restorable any time by re-enabling the scope and re-syncing. These controls already work for Domain, realestate.com.au, and VaultRE today; see [Domain Setup](domain-setup) for how they behave. ### Sold listings When you enable **Sold & off-market listings**, Eagle listings flipped to **SOLD** appear in the **Sold** tab with a red **Sold** badge. Each sold listing carries: * **Sold price** — the agreed sale price. * **Sold date** — the date the sale was agreed. * **Sale method** — shown as **Other** in the Knowledge Base. Eagle MRI's API does not expose the sale method (Auction, Private Treaty, etc.) on a sold property, so your AI agent will quote the price and date without claiming a method. This is an Eagle data-feed gap, not a Voqo limitation. Eagle listings with an **Under Offer** status are treated as still on market — they appear in the **For Sale** tab with an "Under Offer" chip rather than the **Sold** tab. They flip to **Sold** in Voqo once Eagle marks the property as sold. ### Leased listings When you enable **Leased listings**, Eagle rentals flipped to **LEASED** appear in the **For Lease** archive with a **Leased** badge. The card carries: * **Weekly rent** — Eagle's `leasedPrice` value, normalised to weekly. * **Lease start date** — the date Eagle recorded the property as leased. * **Lease end date** — *derived* from the lease start date plus Eagle's `leasedDurationInWeeks` field. * **Lease term (months)** — derived from `leasedDurationInWeeks ÷ 4.345`, rounded. **Limitation — derived lease end date.** Eagle MRI's API does not expose a direct lease end date or a tenancy object on a property. Voqo derives the end date from the original lease duration on the property record. This is accurate for **fresh leases**, but will drift on **lease renewals** or **early termination** — Eagle doesn't update `leasedDurationInWeeks` when a tenancy is extended or cut short. If you need ground-truth lease end dates for renewals, check Eagle directly. Your AI agent is prompted accordingly to phrase lease-end dates with appropriate caveats. ### Off-market listings Eagle listings marked **OFF\_MARKET** or **WITHDRAWN** appear in the **Off-Market** tab with an **Off-Market** badge, rather than being silently removed from the Knowledge Base. Your AI agent prefixes these listings with **"OFF-MARKET —"** when speaking about them, so callers understand the property is not actively available. ### Pre-market listings (Draft) When you enable **Pre-Market listings**, Eagle listings in **DRAFT** status — appraisals you're working on but haven't formally listed yet — appear in the **Pre-Market** tab with a **Pre-Market** badge. These are useful when you want your AI agent to be aware of properties you're pitching, even before the listing goes live. **Default off** so they don't clutter your Knowledge Base if you don't need them. You can hide pre-market listings from your Knowledge Base view without un-syncing them — see [Pre-Market Listings](../knowledge-base/pre-market-listings) for the Hide toggle. ### Upcoming auctions Eagle MRI auction listings now populate Voqo's **Upcoming Auctions** smart-list template. The auction date is pulled from Eagle's `auctionDatetime` field on each property. Build a list under **Quick Create → Upcoming Auctions** and attach it to your AI agent so it can prepare for auction-week calls. *** ## Smart lists for Eagle MRI listings (coming soon) In the Knowledge Base **Quick Create** menu, you can build per-state smart lists that include Eagle MRI stock: * **Sold Properties** — every sold listing (across all integrations); narrow to Eagle with the source filter * **Leased Properties** — every settled leased rental * **Pre-Market Properties** — every Draft-stage Eagle listing (only populated when pre-market scope is on) * **Upcoming Auctions** — every listing with an auction date in the next 14 days **`Lease Properties` vs `Leased Properties`** — these are different lists. **Lease Properties** is your current rental stock available to lease (`For Lease` state). **Leased Properties** is the archive of rentals that have already been leased out. Pick the one that matches your use case. You can also build an **Eagle MRI Properties** list (under *By Integration Source* in Quick Create) that holds every listing synced from Eagle — useful when you want an AI agent to only ever reference your Eagle stock. *** ## Troubleshooting | Issue | What to do | | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Test connection failed** | Double-check that you've copied both the **client ID** and the **client secret** in full from Eagle's Settings → API Credentials page. Re-paste both and test again. | | **Sold listings show "Sale method: Not provided"** | Eagle MRI's API doesn't expose the sale method on a sold property. Sold price and sold date are accurate; method is unavailable from the source feed. | | **Leased lease-end date looks wrong after a renewal** | The lease end date is derived from the original lease duration at the time the lease was created. Eagle doesn't refresh this when a tenancy is renewed or terminated early. Check Eagle directly for the ground-truth date. | | **Under-offer listings don't appear in the Sold tab** | This is correct — Under Offer is treated as still on market. The listing flips to **Sold** once Eagle marks the property as sold. | | **Initial contacts sync is taking longer than the estimate** | The estimate is conservative. Open **Sync History** for the live status — if the job is still **Processing**, it's on track. If it shows **Failed**, hit **Retry**. | | **I see "Connecting" but I can't tell what's happening** | Open **Sync History** from the top of the Integrations page. Active jobs sit at the top with a live spinner and a progress count. | | **A contact I expected is missing** | If you set an **initial backfill limit** at setup, the integration is in test mode — only the capped number of (least recently updated) contacts came in, and the twice-daily delta is paused. Disconnect Eagle and reconnect with the limit field blank to bring in your full contact list and re-enable the ongoing delta sync. | | **A scheduled sync didn't appear** | Check **Sync History** for the latest **Auto** entry on Eagle. Scheduled syncs run at 12pm and 6pm AEDT every day; if you don't see one within an hour of those times, contact support. | ## Disconnect 1. Click **Disconnect** on the Eagle MRI card. 2. Confirm the action. Disconnecting stops all future syncs. Previously synced listings and contacts remain in your workspace but are no longer linked to Eagle — the source badge disappears and scheduled syncs stop. ## Need help? If anything's not working as expected, contact support with your workspace ID and a screenshot of the **Sync History** panel. ## Related docs * [Choose and Connect Integrations](overview-integration) * [Knowledge Base Lists and Sources](knowledge-base-integrations) * [Sold Listings in the Knowledge Base](../knowledge-base/sold-listings) * [Leased Listings in the Knowledge Base](../knowledge-base/leased-listings) * [Pre-Market Listings in the Knowledge Base](../knowledge-base/pre-market-listings)