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 + HubSpot

Native integration

Connect HubSpot once with a private app token. Every enriched lead with an email becomes a HubSpot contact: owner first and last name, email, phone, company, website and address. Contacts are upserted by email, so pushing a search again updates them instead of creating duplicates.

Before you start

Setup

  1. 1

    Create a private app in HubSpot

    Give it the scopes crm.objects.contacts.read and crm.objects.contacts.write, then copy the access token.

  2. 2

    Connect it in LeadMerlin

    Paste the token on the Integrations page of the dashboard, or call the API. The token is tested with one HubSpot call before it is saved, and stored encrypted.

    PUT https://api.leadmerlin.com/api/v2/integrations/hubspot
    Header: x-api-key: lm_your_key
    {"token":"pat-na1-…","auto_push":true}
  3. 3

    Push a search

    Click the HubSpot button above the search results, or call push for any finished job. With auto_push on, every completed search is sent on its own.

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

    Check the result

    GET /v2/integrations shows the last push: how many contacts were sent, skipped and failed, and the last error HubSpot returned.

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.