Instantly action

List Leads (Instantly)

Retrieve a paginated list of leads from Instantly.ai using advanced filters, search, and campaign parameters.

Run in Studio →All Instantly actions
Instantly logoInstantly
instantly-list-leads
integrationReturns in secondsLight tier
Input

What it needs.

Map each field to a column in your table. Optional fields can stay empty.

FieldType
  • limit
    The number of items to return (1-100).
    nullablenumber
  • starting_after
    Forward pagination cursor (Lead ID or Email depending on distinct_contacts setting).
    nullablestring
  • search
    Search string for First Name, Last Name, or Email.
    nullablestring
  • filter
    Filter criteria (e.g., FILTER_VAL_CONTACTED, FILTER_LEAD_INTERESTED).
    nullablestring
  • campaign
    Campaign ID to filter leads.
    nullablestring
  • list_id
    List ID to filter leads.
    nullablestring
  • in_campaign
    Filter for leads that are in a campaign.
    nullableboolean
  • in_list
    Filter for leads that are in a list.
    nullableboolean
  • is_website_visitor
    Filter for leads that are website visitors.
    nullableboolean
  • distinct_contact
    Whether to return distinct contacts.
    nullableboolean
  • enrichment_status
    Filter by enrichment status (1: Success, 11: Pending, -1: N/A).
    nullablenumber
  • esg_code
    Filter by ESG code (e.g., '1', 'all', 'none').
    nullablestring
  • smart_view_id
    Smart view ID to filter leads.
    nullablestring
  • id
    text of lead IDs (UUIDs) to include.
    nullabletext
  • excluded_id
    text of lead IDs (UUIDs) to exclude.
    nullabletext
  • contact
    array of email addresses to filter by.
    nullabletext
  • organization_user_id
    array of organization user IDs to filter leads.
    nullabletext
  • query
    Advanced query objects (e.g. for email open events).
    nullabletext

When to use this.

The "List Leads (Instantly)" action allows users to efficiently retrieve a paginated list of leads from Instantly.ai, utilizing advanced filtering, search capabilities, and campaign parameters. Key input parameters include 'limit' for controlling the number of returned items, 'search' for querying specific lead attributes like first name or email, and various filters such as 'campaign' and 'list_id' to refine results based on user-defined criteria. The action outputs essential lead information, including lead ID, email, first and last names, company details, and engagement metrics like email click and open counts. This functionality is ideal for sales and marketing teams seeking to streamline lead management, enhance targeting strategies, and improve conversion rates through precise data retrieval and analysis. As part of the integration category, this action supports seamless lead generation and management workflows.

Output

What it returns.

Every field this action writes back to the row. Click a line to expand nested objects.

FieldType
  • lead_id
    Lead Id
    string
  • lead_email
    Lead Email
    string
  • lead_first_name
    Lead First Name
    string
  • lead_last_name
    Lead Last Name
    string
  • company_name
    Company Name
    string
  • company_domain
    Company Domain
    nullablestring
  • mobile_number
    Mobile Number
    nullablestring
  • website
    Website
    string
  • email_click_count
    Email Click Count
    nullablenumber
  • email_open_count
    Email Open Count
    nullablenumber
  • email_reply_count
    Email Reply Count
    nullablenumber
  • esp_code
    Esp Code
    nullablenumber
  • lt_interest_status
    Lt Interest Status
    nullablenumber
  • status
    Status
    number
  • organization_id
    Organization Id
    nullablestring
  • personalization
    Personalization
    nullabletext
  • payload_company_name
    Payload Company Name
    nullablestring
  • payload_email
    Payload Email
    nullablestring
  • payload_first_name
    Payload First Name
    nullablestring
  • payload_last_name
    Payload Last Name
    nullablestring
  • payload_mobile_number
    Payload Mobile Number
    nullablestring
  • payload_website
    Payload Website
    nullablestring
  • payload_personalization
    Payload Personalization
    nullabletext
  • payload_has_tried_competitor
    Payload Has Tried Competitor
    nullableboolean
  • payload_past_customer
    Payload Past Customer
    nullableboolean
  • timestamp_created
    Timestamp Created
    nullablestring
  • timestamp_updated
    Timestamp Updated
    nullablestring
  • timestamp_last_interest_change
    Timestamp Last Interest Change
    nullablestring
  • upload_method
    Upload Method
    nullablestring
  • status_summary
    Status Summary
    nullableobject
  • next_starting_after
    Next Starting After
    nullablestring
Workflow

How this fits a workflow.

Trigger → List Leads (Instantly) → enrich → push to your CRM. You set it up once; after that it runs without you.

  1. Step 1TriggerNew row, form submit, or schedule.
  2. Step 2List Leads (Instantly)The Instantly action runs.
  3. Step 3EnrichWaterfall fills missing fields.
  4. Step 4Push to CRMHubSpot / Pipedrive / Zoho CRM / GoHighLevel.

Two actions you can chain after this one:

List Leads (Instantly)List Campaigns (Instantly)Add Lead To Sequence (Instantly)
Reliability

Throughput & reliability.

How fast it drains a table, and what happens when the upstream provider has a bad day.

  • Per-minute limitNo public cap
  • Per-day limitPlan-defined
  • RetriesAutomatic w/ backoff
  • Failed lookupsZero credits

Who runs this

GTM EngineerRevOpsAgency

Light tier. See pricing; per-action credit cost is private.

Related

More Instantly actions.

FAQ.

Mostly. Fast actions fill the cell in a few seconds. Long-running ones run in the background and write back to the row when they finish, so you can close the tab.

No. A failed lookup costs zero credits. When a provider misses or times out, the waterfall moves to the next one and you only pay for the match you actually got.

No. Run it on one cell, on a selection, on the whole table, or on a schedule. Same action either way.

HubSpot, Pipedrive, Zoho, and GoHighLevel are bidirectional, with Salesforce coming soon. Smartlead, Instantly, Lemlist, HeyReach, Apollo Sequences, and Reply.io for outbound.

Run List Leads (Instantly) in 60 seconds.

Connect the account, drop the action on a column, run it on your rows.

Start free →All Instantly actions