List Leads (Instantly)
Instantly → List Leads (Instantly)
/v1/instantly-list-leads{ "limit": 1, "starting_after": "sample-value", "search": "sample-value", "filter": "sample-value", "campaign": "sample-value", "list_id": "sample-value", "in_campaign": true, "in_list": true, "is_website_visitor": "https://acme.com", "distinct_contact": true, "enrichment_status": 1, "esg_code": "sample-value", "smart_view_id": "sample-value", "id": "sample-value", "excluded_id": "sample-value", "contact": "sample-value", "organization_user_id": "Acme, Inc.", "query": "sample-value" }
{ "ok": true, "data": { "lead_id": "rec_4f3a91", "lead_email": "[email protected]", "lead_first_name": "sample", "lead_last_name": "sample", "company_name": "sample", "company_domain": "https://acme.com", "mobile_number": "sample", "website": "https://acme.com", "email_click_count": "[email protected]", "email_open_count": "[email protected]", "email_reply_count": "[email protected]", "esp_code": 1, "lt_interest_status": "valid", "status": "valid", "organization_id": "rec_4f3a91", "personalization": "sample", "payload_company_name": "sample", "payload_email": "[email protected]", "payload_first_name": "sample", "payload_last_name": "sample", "payload_mobile_number": "sample", "payload_website": "https://acme.com", "payload_personalization": "sample", "payload_has_tried_competitor": true, "payload_past_customer": true, "timestamp_created": "sample", "timestamp_updated": "sample", "timestamp_last_interest_change": "sample", "upload_method": "sample", "status_summary": "valid", "next_starting_after": "sample" } }
Retrieve a paginated list of leads from Instantly.ai using advanced filters, search, and campaign parameters.
Install
Add list leads (instantly) to your MCP client.
Drop this into claude_desktop_config.json (or your client's equivalent) and the tool shows up in any chat.
{ "mcpServers": { "texau": { "command": "npx", "args": ["-y", "@texau/mcp-server"], "env": { "TEXAU_API_KEY": "..." } } } }
Tool name: texau__instantly-list-leads
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.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
List Leads (Instantly)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
lead_idLead Idstringlead_emailLead Emailstringlead_first_nameLead First Namestringlead_last_nameLead Last Namestringcompany_nameCompany Namestringcompany_domainCompany Domainnullablestringmobile_numberMobile NumbernullablestringwebsiteWebsitestringemail_click_countEmail Click Countnullablenumberemail_open_countEmail Open Countnullablenumberemail_reply_countEmail Reply Countnullablenumberesp_codeEsp Codenullablenumberlt_interest_statusLt Interest StatusnullablenumberstatusStatusnumberorganization_idOrganization IdnullablestringpersonalizationPersonalizationnullabletextpayload_company_namePayload Company Namenullablestringpayload_emailPayload Emailnullablestringpayload_first_namePayload First Namenullablestringpayload_last_namePayload Last Namenullablestringpayload_mobile_numberPayload Mobile Numbernullablestringpayload_websitePayload Websitenullablestringpayload_personalizationPayload Personalizationnullabletextpayload_has_tried_competitorPayload Has Tried Competitornullablebooleanpayload_past_customerPayload Past Customernullablebooleantimestamp_createdTimestamp Creatednullablestringtimestamp_updatedTimestamp Updatednullablestringtimestamp_last_interest_changeTimestamp Last Interest Changenullablestringupload_methodUpload Methodnullablestringstatus_summaryStatus Summarynullableobjectnext_starting_afterNext Starting Afternullablestring
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/instantly-list-leads. Auth: x-api-key.
/v1/instantly-list-leadscurl -X POST 'https://v3-api.texau.com/api/v1/instantly-list-leads' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"limit":1,"starting_after":"sample-value","search":"sample-value","filter":"sample-value","campaign":"sample-value","list_id":"sample-value","in_campaign":true,"in_list":true,"is_website_visitor":"https://acme.com","distinct_contact":true,"enrichment_status":1,"esg_code":"sample-value","smart_view_id":"sample-value","id":"sample-value","excluded_id":"sample-value","contact":"sample-value","organization_user_id":"Acme, Inc.","query":"sample-value"}'
{ "ok": true, "data": { "lead_id": "rec_4f3a91", "lead_email": "[email protected]", "lead_first_name": "sample", "lead_last_name": "sample", "company_name": "sample", "company_domain": "https://acme.com", "mobile_number": "sample", "website": "https://acme.com", "email_click_count": "[email protected]", "email_open_count": "[email protected]", "email_reply_count": "[email protected]", "esp_code": 1, "lt_interest_status": "valid", "status": "valid", "organization_id": "rec_4f3a91", "personalization": "sample", "payload_company_name": "sample", "payload_email": "[email protected]", "payload_first_name": "sample", "payload_last_name": "sample", "payload_mobile_number": "sample", "payload_website": "https://acme.com", "payload_personalization": "sample", "payload_has_tried_competitor": true, "payload_past_customer": true, "timestamp_created": "sample", "timestamp_updated": "sample", "timestamp_last_interest_change": "sample", "upload_method": "sample", "status_summary": "valid", "next_starting_after": "sample" } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
Output
Results land in a TexAu table.
Sample rows below.
Real result preview coming soon.
| Input | Status | Score |
|---|---|---|
| [email protected] | valid | 96 |
| [email protected] | risky | 54 |
| [email protected] | invalid | 12 |
Workflow
A real example.
Trigger → list leads (instantly) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.
Built for
Who runs this.
Reliability
Rate limits & reliability.
- Per-minute limitNo public cap
- Per-day limitPlan-defined
- RetriesAutomatic w/ backoff
- ModeSync
Errors
HTTP status codes.
What each response means and what to do about it.
| Code | Cause | Fix |
|---|---|---|
| 200 OK | Action ran. Data in `data`. | Read response. |
| 400 Bad Request | Missing or malformed input. | Validate against the input schema. |
| 401 Unauthorized | Missing or invalid `x-api-key`. | Re-issue from /api-platform. |
| 403 Forbidden | Workspace lacks plan tier. | Upgrade or contact sales. |
| 404 Not Found | Action key not recognized. | Verify the slug. |
| 429 Rate Limited | Per-minute or per-day cap hit. | Backoff; reduce concurrency. |
| 500 Server Error | Unexpected TexAu issue. | Retry with backoff. |
| 502 Bad Gateway | Upstream provider 5xx. | Retry; we surface root cause. |
| 504 Timeout | Upstream slower than maxLatency. | Switch to `isAsync` polling. |
Related
More Instantly actions.
FAQ.
Is this real-time?
Yes. Synchronous actions return in ~1–4 s. Long-running work uses async polling (see status 504 → switch to async).
Do I get charged on failure?
No. Verified failures cost zero credits. Provider miss / 5xx / timeout cascade to the next provider in the waterfall when applicable.
Does it work with Claude / Cursor via MCP?
Yes. Add the texau MCP server to your client config, then call `texau__instantly-...` directly.
What CRMs can I push results to?
HubSpot, Salesforce, Pipedrive, Zoho, and GoHighLevel are bidirectional. Smartlead, Instantly, Lemlist, HeyReach, Apollo Sequences, and Reply.io for outbound.
Run List Leads (Instantly) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.