Seller Compass

Developer Documentation

Complete technical reference for integrating with the Seller Compass platform. REST API endpoints, CRM configuration guides, webhook setup, Zapier automation, and calendar sync.

Getting Started — API Authentication

All API requests require a Bearer token in the Authorization header. Generate API keys from your Agent Dashboard under Settings → API Keys. Keys use the sc_live_ prefix and are hashed with SHA-256 before storage — they are shown only once on creation.

Base URL: https://sellercompass.net/api/v1

REST API Reference

Query your listing data and activity streams programmatically. All endpoints return JSON and are scoped to the authenticated agent's data.

GET /api/v1/listings — Retrieve all listings for the authenticated agent.

GET /api/v1/listings/:id — Get details for a specific listing by UUID.

GET /api/v1/listings/:id/activities — Get the activity stream for a specific listing.

GET /api/v1/activities — Get all activities across your portfolio.

CRM Integration Guides

Seller Compass integrates bidirectionally with four major real estate CRMs. Connect from your Agent Dashboard under Settings → CRM Integration.

Follow Up Boss: Full native integration — leads, contacts, deals, tasks, notes, and tags sync bidirectionally. Contact IDs stored for instant future syncs.

kvCORE / BoldTrail: Lead sync, notes, and tags. Deals and tasks use intelligent note-based workarounds since the kvCORE API lacks native support.

Lofty / Chime: Same capabilities as kvCORE — bidirectional lead sync, notes, tags, with note-based deal and task tracking.

HubSpot: Native CRM connector via Replit integration. Contact sync, deal tracking through pipeline stages, and activity logging.

All CRM integrations include automatic retry with exponential backoff, full audit logging via the crm_sync_log table, auto-deal creation on listing creation, and bidirectional contact ID persistence.

Webhooks — Outbound & Inbound

Outbound: Register HTTPS endpoints in Settings → Webhooks → Register URL and subscribe to events: activity.showing, activity.open_house, activity.feedback, activity.offer, activity.stage_change, lead.created, and lead.updated. Payloads are signed with HMAC-SHA256 via the X-Webhook-Signature header. 3-attempt retry with exponential backoff. Every delivery attempt is logged with status code, response time, and payload hash in delivery logs.

Inbound — Universal Receiver: POST to /api/webhooks/ingest with Bearer token auth. Accepts flat JSON payloads from any source. Smart listing matching by UUID, MLS number, address, or CRM deal ID. Automatic deduplication by external_id.

Inbound — CRM-Specific: POST to /api/crm/inbound/:provider (followupboss, kvcore, lofty, hubspot). Auth via Bearer token using your agent API key. Each endpoint understands the native CRM payload format and normalizes it into the unified activity stream.

Auto-Import, Soft Merge & Cross-CRM Sync: Leads arriving via CRM inbound webhooks are automatically imported with soft merge — matching contacts are merged by email/phone without overwriting existing data. If multiple CRM integrations are enabled, imported leads auto-sync to all connected CRMs (e.g., a lead from Follow Up Boss syncs to kvCORE, Lofty, and HubSpot). After import, lead.created or lead.updated outbound webhook events fire to registered endpoints.

Zapier & No-Code Automation

Connect Seller Compass to 6,000+ apps through Zapier using the universal webhook receiver and REST API. Payloads use flat JSON format designed for no-code platforms. Create Zaps that push showing feedback to Google Sheets, send Slack notifications on new offers, auto-create tasks in Asana, or sync leads to email marketing platforms.

Smart listing matching accepts property UUID, MLS number, full or partial address, or CRM deal ID — making it easy to route data from any external system to the correct listing.

ShowingTime Feedback — Built-In Email Monitor

Recommended: Connect your Gmail in Settings → Integrations for zero-setup ShowingTime feedback capture. Seller Compass monitors your inbox every 10 minutes, automatically detecting emails from noreply@showingtime.com with subject "FEEDBACK RECEIVED | [ADDRESS]". The built-in parser extracts interest level, experience rating, price opinion, listing rating, and buyer agent comments — then matches the listing by address and creates an activity feed entry for agent review.

Alternative — Zapier Workflow: (1) Gmail trigger watches for ShowingTime feedback emails. (2) Zapier Formatter extracts address and feedback fields. (3) Code step formats data into JSON with source "showingtime" and type "feedback". (4) Webhooks by Zapier POSTs to /api/webhooks/ingest with Bearer token auth. The webhook receiver auto-matches by address. Both methods result in the same activity feed entry for agent approval.

Calendar Sync — iCal/ICS Feed

Subscribe to your personal calendar feed at /api/calendar/feed/:token from Google Calendar, Apple Calendar, or Microsoft Outlook. The feed includes scheduled showings and closing dates, updated in real time. Each agent gets a unique UUID token for secure access.

Activity Ingestion Engine

The unified listing_activities table normalizes data from all sources — system events, CRM updates, webhooks, and Zapier — into a single chronological timeline per listing. Indexed on listing_id, agent_id, occurred_at, and provider with unique constraint on external_id for deduplication.

Agent Control Layer: External activities default to pending status (visibleToSeller=false), requiring agent review before sellers see them. System events auto-approve. Agents can approve, approve & notify seller via email, or hide activities from their dashboard.

Start Building Today

Start your 14-day free trial and get instant access to the REST API, webhooks, CRM integrations, and calendar sync. All developer features included at $29/month.

Start Free Trial