Black Friday:40% off your first payment with code BF2026. On yearly plans, that's the whole first year. Until December 2.

Integration guide

LeadMerlin + GoHighLevel

Native integration

Agencies on GoHighLevel can send LeadMerlin leads directly into a client sub-account. Each lead becomes a contact tagged leadmerlin and the search keyword, ready for workflows and campaigns. Contacts are upserted, so pushing again updates them.

Before you start

Setup

  1. 1

    Create a private integration

    In the sub-account settings, create a private integration with the scopes contacts.write and locations.readonly. Copy the token and the Location ID.

  2. 2

    Connect it in LeadMerlin

    Paste the token and Location ID on the Integrations page, or call the API. The token is tested before it is saved, and stored encrypted.

    PUT https://api.leadmerlin.com/api/v2/integrations/gohighlevel
    Header: x-api-key: lm_your_key
    {"token":"pit-…","location_id":"your_location_id","auto_push":true}
  3. 3

    Push a search

    Use the GoHighLevel button above the search results, or call push for any finished job. auto_push sends every completed search.

    POST https://api.leadmerlin.com/api/v2/jobs/{job_id}/push
    {"provider":"gohighlevel"}
  4. 4

    Start a workflow on the tag

    Trigger a GoHighLevel workflow on "Contact tag added: leadmerlin" to start outreach the moment new leads land.

Location codes in these examples are placeholders — always look yours up with GET /v2/locations first.

Tips

API at a glance

CallWhat it does
GET /v2/locations?q=City name → location_code (free)
GET /v2/suggest?niche=Vague niche → Google categories + sharper keywords (free)
POST /v2/searchesStart a search job: keyword, 1–5 location_codes, optional strictness
POST /v2/enrichmentsEnrich up to 100 domains you already have
GET /v2/jobs/:idPoll until status is completed
GET /v2/jobs/:id/resultsPaginated enriched businesses (cursor, limit ≤ 200)
/v2/demo/*Same shapes on fixture data — no key, no credits

All calls use the x-api-key header except the demo endpoints. Base URL: https://api.leadmerlin.com/api

Related

Get your API key.

Sign up free to get an lm_ key and 100 enriched leads. No credit card.