Integration guide
LeadMerlin + GoHighLevel
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
- A GoHighLevel sub-account where you can create private integrations.
- A LeadMerlin account (100 free leads, no card).
Setup
- 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
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
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
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
- Leads need an email or a phone to be pushed; mobile numbers are marked by phone line type, which helps decide who gets SMS.
- One connection per LeadMerlin account. For several client sub-accounts, use one LeadMerlin login per client or a webhook with Make or Zapier.
- Sending is paced under the GoHighLevel API limit, so a large search takes a minute or two to arrive.
API at a glance
| Call | What it does |
|---|---|
| GET /v2/locations?q= | City name → location_code (free) |
| GET /v2/suggest?niche= | Vague niche → Google categories + sharper keywords (free) |
| POST /v2/searches | Start a search job: keyword, 1–5 location_codes, optional strictness |
| POST /v2/enrichments | Enrich up to 100 domains you already have |
| GET /v2/jobs/:id | Poll until status is completed |
| GET /v2/jobs/:id/results | Paginated 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.