For developers and operations teams

Connect Realvory to the tools your team already uses.

Generate API keys, configure real-time webhooks, and import client data — so client workflows and property research flow between Realvory and your CRM, dashboard, or automation platform.

Why integrate

Advisors and agencies often work across several tools: a CRM for client management, a communication platform for updates, and Realvory for property research. The integration layer bridges those worlds without requiring manual data entry or spreadsheet exports.

What it helps with

  • Pull client and shortlist data into your CRM or internal tools.
  • Receive real-time webhooks when clients view or respond to shortlists.
  • Import client lists from any CSV or spreadsheet in one step.
  • API keys are stored as secure hashes — keys shown only once at creation.

Informational tools to support screening and due diligence. Not financial, investment, or real estate advice.

Three integration paths

Choose the path that fits your workflow

REST API for read access

Generate API keys in Settings and read your client list and shortlist data programmatically. Both endpoints accept Bearer token authentication or existing cookie sessions. Ideal for pulling structured property and client context into your own dashboards or CRM automations.

Webhooks for real-time events

Subscribe to client engagement events: shortlist shared, viewed, and feedback received. Each webhook delivers a JSON payload signed with HMAC-SHA256 so your server can verify authenticity. No polling, no manual refresh — your CRM stays current as activity happens.

CSV import for bulk onboarding

Moving from another CRM or spreadsheet? Upload a CSV, map the columns to Realvory fields, and import your entire client list in one step. The importer checks for duplicate emails, stores unmapped columns as metadata, and shows a detailed summary when complete.

API access

  • Generate secure API keys with rv_ prefix and SHA-256 storage.
  • Read clients: GET /api/clients with portfolio, status, and mandate data.
  • Read shortlists: GET /api/clients/{id}/shortlists with engagement metrics.
  • Authenticate via Bearer token or existing session cookie.

Webhook delivery

  • client.shortlist_shared — fires when a shortlist is sent to a client.
  • client.shortlist_viewed — fires when a client opens the shortlist.
  • client.feedback_received — fires on interested, not-for-me, and more.
  • Every payload is HMAC-SHA256 signed with your unique webhook secret.

CSV import

  • Upload .csv files or paste tabular data from any spreadsheet.
  • Auto-detected column mapping with manual override.
  • Duplicate email detection against your existing client list.
  • Unmapped columns stored as custom metadata on each client record.

FAQ

Common questions

What can I build with the Realvory API?

Pull client lists, shortlist data, property context, and viewer engagement into your own CRM, dashboard, reporting tool, or internal workflow. API keys give read access to structured data without scraping or manual export.

How does API authentication work?

Generate an API key in Settings → Integrations. Include it in requests as an Authorization: Bearer header. Keys are stored as secure hashes — the full key is shown only once at creation time. Revoke a key at any time if needed.

What API endpoints are available?

GET /api/clients returns your client list with portfolio counts, status, budget, yield targets, and preferred areas. GET /api/clients/{id}/shortlists returns active shortlists for a specific client with item counts, view totals, and feedback counts.

How do webhooks work?

Configure a webhook URL in Settings → Integrations, select which events to receive (shortlist shared, viewed, feedback received), and copy the signing secret. Realvory POSTs JSON payloads to your URL with an HMAC-SHA256 signature header for verification.

What events can I subscribe to via webhooks?

Three events are available: client.shortlist_shared (when you send a shortlist to a client), client.shortlist_viewed (when a client opens the shortlist), and client.feedback_received (when a client marks a property as interested, not-for-me, or leaves other feedback).

How do I verify webhook authenticity?

Each request includes an X-Realvory-Signature header containing an HMAC-SHA256 hex digest of the raw request body, computed with your webhook secret. On your server, compute the same HMAC and compare it to the header. Matching signatures confirm the payload came from Realvory and was not tampered with.

How do I import my existing client list?

Use the CSV import tool at /clients/import. Upload a CSV file or paste tabular data from any spreadsheet. The importer auto-detects column headers, lets you map them to Realvory fields, checks for duplicate emails, and stores unmapped columns as custom metadata.

Ready to connect Realvory to your workflow?

API keys and webhooks are available on Advisor and Team plans. Import your existing client list from any CSV to get started, then configure integrations in Settings.