Misar IO Docs

Changelog

Version history for MisarReach — lead finder, deals pipeline, and AI scoring.

v1.0.0

Initial release

Lead Finder

  • POST /api/lead-finder/search — asynchronous natural-language lead search using Hunter.io. Returns a jobId immediately; poll /jobs/:jobId for status. Credit-gated with free-plan monthly allowance (25 searches/month).

  • POST /api/lead-finder/discover — synchronous company discovery via Hunter.io Discover. Accepts structured filters (industry, location, headcount, technology). Optionally fetches contact emails for discovered companies.

  • GET /api/lead-finder/leads — paginated list of all saved lead results with search/filter support.

  • POST /api/lead-finder/verify — email deliverability verification via Hunter.io Email Verifier. Supports single or batch (max 20) verification. Updates verify_status and verify_score on lead records.

  • POST /api/lead-finder/score — AI-powered lead scoring running in the background. Accepts jobId (score all unscored results) or leadIds (selective). Max 200 leads per call.

  • GET/POST /api/lead-finder/lists — Hunter.io lead list management (list and create).

  • POST /api/lead-finder/lists/:listId/sync — sync a lead list to a campaign.

  • POST /api/lead-finder/enrich — enrich existing lead records with additional data.

  • POST /api/lead-finder/preview-message — preview AI-generated outreach message for a lead.

Deals & Pipeline

  • GET/POST /api/deals — full deals CRUD with revenue summary (total, closed, pipeline). New deals start in status = "new".

  • PATCH /api/deals/:id — update deal status, value, and notes. Setting status = "closed" automatically records closed_at.

  • GET /api/pipeline — Kanban board with deals grouped by stage and revenue totals. Excludes lost deals from revenue calculations.

  • POST /api/pipeline — move a deal to a new stage (drag-and-drop action). Seven stages: newcontactedinterestedmeetingproposalclosed / lost.

Authentication & credits

  • API key authentication via Authorization: Bearer msr_... header.
  • Scope-based access control: leads:search, leads:verify, leads:score, leads:read, deals:read, deals:write.
  • Credit wallet system: search jobs, email verifications, and AI scoring each consume credits.
  • Free plan: 25 lead searches per calendar month without credit cost.

Autopilot

  • POST /api/autopilot/start — start an AI-driven outreach sequence run.
  • GET /api/autopilot/:id/status — get run status.
  • GET /api/autopilot/runs — list all runs.

All MisarReach services are monitored at status.misar.io.