Skip to content

Every 60 minutes

Copy Hunter leads to Google Sheets

Leads saved in a Hunter leads list are copied to a Google Sheets tab with name, email, company, position and verification status.

Runs
Every 60 minutes
Apps
Google Sheets, Hunter.io
AI
Not needed
Access
Hunter API key; Google Sheets read+write

Send this to your assistant

Create a ClickRuntime automation: every hour, copy new leads from my Agencies Q3 leads list in Hunter into the Leads tab of my sheet with first name, last name, email, company, position and verification status.

Paste it into your assistant. It tells you what it will send or change before it runs live.

First time? Adding ClickRuntime to your assistant takes about two minutes.

Why use it

Why teams use this automation

Hunter is good at finding and saving prospects, but outreach sequences, CRM imports and team assignments usually happen from a spreadsheet. Exporting a CSV every time a list grows is easy to forget.

This automation copies new leads from a Hunter list into Google Sheets every hour, with the email's verification status, so the sheet always has the latest prospects.

Founders doing their own outbound, sales development reps and agencies use it to keep prospect lists in one shared place.

What you get out of it

  • Prospects land where outreach happens

    Mail merges, sequences and CRM imports can read straight from the sheet.

  • Verification status included

    Filter out invalid or risky emails before sending.

  • No repeat rows

    Lead IDs already copied are remembered.

  • Team-friendly

    Add an Owner column and split leads between reps.

  • No credits spent

    Copying saved leads does not use Hunter searches.

How it works

What happens, step by step

  1. Every hour ClickRuntime reads the leads in the Hunter list you choose.

  2. Leads it has not copied before are picked out.

  3. Each one becomes a row with name, email, company, position, LinkedIn and email verification status.

Before it runs live

  • Connect your Google Sheets account and pick the spreadsheets it may use
  • Connect Hunter.io

What you get

RunsEvery 60 minutes
Copy Hunter leads to Google Sheetstoday, 9:00Succeeded
Google Sheets · Prospecting › LeadsLaura | Becker | laura@pixelfold.de | Pixelfold | Head of Partnerships | linkedin.com/in/laurabecker | valid

Build your own

Need it to work differently?

This template is a starting point. Copy the prompt and change it, or describe a different automation from scratch, with your own conditions, more apps or an AI step. Your assistant writes it, tests it and runs it on ClickRuntime.
  • Your own rules

    Conditions, thresholds, filters and exceptions, written the way you'd explain them to a colleague.

  • Any number of apps

    One automation can read from one app and update several others. Over 248 apps are ready, and anything with an API works too.

  • AI where it helps

    Summaries, classification, extraction and drafts use ClickRuntime's built-in AI, with no extra key.

  • On a schedule or on each event

    Runs as often as every 5 minutes, or the moment an app sends an event, and keeps track of what it already handled.

Changes you can ask for

  • Act only on the items that match your own rules, and skip the rest
  • Add an AI step, for example to summarize, sort or draft a reply
  • Add another app, for example also send it to Slack
  • Combine it with other Google Sheets and Hunter.io steps into one automation

Under the hood

The code that runs this automation

This is the Python script that runs each time the automation starts. Your AI assistant writes it for you when you send the prompt, and you allow each step in your assistant. To change how the automation works, describe the change to your assistant and it updates the script for you. For every function it can use, see the script reference.
copy_hunter_leads_to_google_sheets.pyexample
from google.oauth2.credentials import Credentials
from googleapiclient.discovery import build
from clickruntime import on_trigger, credentials, http, state, report_fetched

LIST_ID = 123456
SHEET_ID = "your-spreadsheet-id"

@on_trigger
def run(event):
    key, copied, leads, offset = credentials.secret("HUNTER_API_KEY"), set(state.get("copied") or []), [], 0
    while True:
        data = http.get("https://api.hunter.io/v2/leads", params={"leads_list_id": LIST_ID, "limit": 100,
                        "offset": offset, "api_key": key}).json()["data"]["leads"]
        leads += data
        if len(data) < 100:
            break
        offset += 100
    new = [l for l in leads if l["id"] not in copied]
    report_fetched(len(new))
    if not new:
        return {"new": 0}
    rows = [[l.get("first_name") or "", l.get("last_name") or "", l["email"], l.get("company") or "", l.get("position") or "",
             l.get("linkedin_url") or "", (l.get("verification") or {}).get("status") or ""] for l in new]
    build("sheets", "v4", credentials=Credentials(credentials.connection("google", "work")), cache_discovery=False) \
        .spreadsheets().values().append(spreadsheetId=SHEET_ID, range="Leads!A:G", valueInputOption="RAW",
                                        body={"values": rows}).execute()
    state.set("copied", list(copied | {l["id"] for l in new})[-5000:])
    return {"new": len(new)}

FAQ

Common questions

Does copying leads use Hunter credits?
No. Reading leads you already saved does not cost searches or verifications. Credits are only used when you find or verify emails.
Where do I find the list ID?
Open the list in Hunter; the number in the address bar is the list ID. Your assistant can also list your leads lists through the API to find it.
Can it copy every list at once?
Yes. Drop the list filter to copy all leads, and ask for a List column so you can tell them apart.
What permissions does it need?
Hunter API key; Google Sheets read+write. Nothing else in your accounts is used.
Does it need AI?
No. It runs without AI, so it doesn't use your plan's AI allowance.
How many runs does it use?
One run each time it checks. Checks that find nothing new and stop right away aren't counted.
Can I change how it works?
Yes. Describe the change to your AI assistant, for example a different schedule, channel or filter. It updates the automation, tests it and tells you what changed.

Set up “Copy Hunter leads to Google Sheets” from your assistant

Copy the prompt above, or connect your assistant first. Free plan, no credit card.