Ads API
Build a LinkedIn company audience from your MisarReach data for ad targeting — api.misar.io/reach/api/ads.
The Ads family turns MisarReach lead data into audiences you can push to ad platforms. Today it exposes LinkedIn company-audience export.
Base URL: https://api.misar.io/reach/api · Auth: Authorization: Bearer mrk_…
Response bodies on the developer contract are open-form — the example below shows representative fields.
LinkedIn company audience
/api/ads/linkedin/company-audienceBuilds a LinkedIn-ready company audience from a set of leads, a saved search, or a lead list. This is a rate-limited (api tier) endpoint. Required scope: leads:read.
Request body — the audience source (e.g. a jobId, listId, or an explicit set of company domains) to compile into a LinkedIn company match audience.
curl -X POST https://api.misar.io/reach/api/ads/linkedin/company-audience \
-H "Authorization: Bearer mrk_your_key_here" \
-H "Content-Type: application/json" \
-d '{ "jobId": "uuid" }'{
"ok": true,
"audience": { "companies": 84, "matched": 71 }
}Status codes
| Code | Meaning |
|---|---|
201 | Audience compiled |
403 | Missing leads:read scope |
422 | Validation error — no valid audience source supplied |
429 | Rate limit exceeded — retry after Retry-After |
See Rate limits and Errors.
Settings API
Read and set the outreach sender address for your MisarReach account — api.misar.io/reach/api/settings.
Consent & Opt-in API
Double opt-in capture, STOP/opt-out handling, and the delivery-events webhook — how MisarReach proves consent and honours revocation across email, SMS, and WhatsApp.