MisarMisar Docs
MisarMailMisarBlogMisarReachMisarPostMisarDevMisarCoderMisarSEOMisar PlatformMisar SSO
SDKs

Java SDK

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

Official Java client for the MisarReach developer API (https://api.misar.io/reach/api). Full coverage of Lead Finder, deals & pipeline, multi-channel outreach, autopilot, sales agent, campaigns, contacts, conversations, workspaces, settings, and ads — plus the SSE lead-job stream. Every method has a synchronous and an *Async (CompletableFuture) variant. Requires Java 17+.

Install (Maven)

<dependency>
    <groupId>io.misar</groupId>
    <artifactId>misarreach-java</artifactId>
    <version>1.0.0</version>
</dependency>

Configure

Authenticate with an mrk_ bearer key. Methods take and return Map<String, Object>.

import io.misar.reach.MisarReachClient;
import java.util.Map;

MisarReachClient client = new MisarReachClient.Builder("mrk_...")
        .maxRetries(5)
        .build();

Lead search + SSE stream

Map<String, Object> job = client.leads.search(Map.of("query", "SaaS founders", "useAI", true));
String jobId = (String) job.get("jobId");

// Stream job progress over Server-Sent Events (blocking)
client.leads.stream(jobId, event -> System.out.println("progress: " + event.get("progress")));

// Async search
client.leads.searchAsync(Map.of("query", "CTOs"))
        .thenAccept(res -> System.out.println(res.get("jobId")));

Deals & channels

client.deals.create(Map.of("leadEmail", "cto@acme.com", "value", 5000));
client.channels.status();

Resources

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

Requests retry idempotently on 429/500/502/503/504 with exponential backoff.

Errors

Non-2xx responses throw MisarReachExceptiongetStatus() returns the HTTP status; the message is extracted from the standard { "error": { "message" } } envelope. Network errors carry status 0.

See the API Reference and SSE stream.