Install and use the MisarReach Ruby SDK — lead finder, SSE job streaming, deals/pipeline CRM, channels, autopilot, and the sales agent.

Official Ruby client for the MisarReach developer API — lead finder (23 sources), multi-channel outreach, CRM (deals + pipeline), autopilot, and the AI sales agent. Pure Net::HTTP, no runtime dependencies. Base URL https://api.misar.io/reach/api, auth Authorization: Bearer mrk_....

Install

Gemfile

gem "misarreach"

Configure

require "misar_reach"

reach = MisarReach.new(api_key: ENV["MISARREACH_API_KEY"])   # mrk_...

Lead search + SSE stream

job = reach.leads.search(query: "Series A SaaS founders", location: "US")

# Live progress via Server-Sent Events
reach.leads.stream_job(job["jobId"]) do |evt|
  puts "#{evt[:event]}: #{evt[:data].inspect}"   # progress … then complete / error
end

reach.leads.enrich(email: "jane@acme.com")
reach.leads.verify(emails: ["jane@acme.com"])

Deals & channels

deal = reach.deals.create(title: "Acme expansion", value: 12_000, stage: "qualified")
reach.pipeline.get
reach.deals.suggestions(deal["id"])

reach.channels.status
reach.channels.connect_whatsapp(phoneNumberId: "...", token: "...")

reach.autopilot.start(campaignId: "camp_1")
reach.sales_agent.process(conversationId: "conv_1")

Resources

leads · deals · pipeline · channels · autopilot · sales_agent · campaigns · contacts · conversations · workspaces · settings · ads.

Automatic retries with backoff on 429/5xx (honours Retry-After).

Errors

Class	When
`MisarReach::AuthError`	401 / 403 — missing or wrong-scope key
`MisarReach::NotFoundError`	404
`MisarReach::RateLimitError`	429 (`retry_after`, `balance`, `free_remaining`)
`MisarReach::UpgradeRequiredError`	429 with `upgrade: true`
`MisarReach::ApiError`	any other non-2xx (`status`, `code`, `body`)
`MisarReach::NetworkError`	connectivity failure

See the API Reference and SSE stream.

Ruby SDK