Get Leads from Campaign (HeyReach)
HeyReach → Get Leads from Campaign (HeyReach)
/v1/heyreach-get-leads-from-campaign{ "campaign_id": "sample-value", "limit": 1, "offset": 1 }
{ "ok": true, "data": { "lead_id": "rec_4f3a91", "created_time": "sample", "last_action_time": "sample", "lead_campaign_status": "valid", "lead_campaign_status_message": "valid", "lead_connection_status": "valid", "lead_message_status": "valid", "linkedin_sender_full_name": "sample", "linkedin_sender_id": "rec_4f3a91", "linkedin_account_id": 1, "profile_first_name": "sample", "profile_last_name": "sample", "profile_headline": "sample", "profile_about": "sample", "profile_company_name": "sample", "profile_company_url": "https://acme.com", "profile_email_address": "[email protected]", "profile_connection": 1, "profile_follower": 1, "profile_image_url": "https://acme.com", "profile_location": "sample", "profile_position": "sample", "profile_url": "https://acme.com", "profile_linkedin_id": "rec_4f3a91", "total_count": 1 } }
Retrieve LinkedIn leads and profile details from a specific HeyReach campaign.
Install
Add get leads from campaign (heyreach) 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__heyreach-get-leads-from-campaign
When to use this.
The "Get Leads from Campaign" action in HeyReach enables users to efficiently retrieve LinkedIn leads and their profile details from a specified HeyReach campaign. By providing the unique campaignId, users can access a curated list of leads, with optional parameters for limit and offset to manage the volume of data retrieved. The output includes essential lead information such as leadId, creationTime, leadCampaignStatus, and detailed profile attributes including firstName, lastName, jobTitle, and LinkedIn profile URL. This action is particularly useful for marketing teams and sales professionals looking to analyze campaign performance, track lead engagement, and enhance their outreach strategies. Categorized under integration, this action streamlines the process of lead management and data analysis, making it an invaluable tool for businesses leveraging LinkedIn for lead generation.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Get Leads from Campaign (HeyReach)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
lead_idLead Idnullablenumbercreated_timeCreated Timenullablestringlast_action_timeLast Action Timenullablestringlead_campaign_statusLead Campaign Statusstringlead_campaign_status_messageLead Campaign Status Messagenullablestringlead_connection_statusLead Connection Statusnullablestringlead_message_statusLead Message Statusnullablestringlinkedin_sender_full_nameLinkedin Sender Full Namenullablestringlinkedin_sender_idLinkedin Sender Idnullablenumberlinkedin_account_idLinkedin Account Idnullablestringprofile_first_nameProfile First Namestringprofile_last_nameProfile Last Namestringprofile_headlineProfile Headlinestringprofile_aboutProfile Aboutnullablestringprofile_company_nameProfile Company Namestringprofile_company_urlProfile Company Urlnullablestringprofile_email_addressProfile Email Addressstringprofile_connectionProfile Connectionnullablenumberprofile_followerProfile Followernullablenumberprofile_image_urlProfile Image Urlnullablestringprofile_locationProfile Locationnullablestringprofile_positionProfile Positionnullablestringprofile_urlProfile Urlstringprofile_linkedin_idProfile Linkedin Idnullablestringtotal_countTotal Countnullablenumber
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/heyreach-get-leads-from-campaign. Auth: x-api-key.
/v1/heyreach-get-leads-from-campaigncurl -X POST 'https://v3-api.texau.com/api/v1/heyreach-get-leads-from-campaign' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"campaign_id":"sample-value","limit":1,"offset":1}'
{ "ok": true, "data": { "lead_id": "rec_4f3a91", "created_time": "sample", "last_action_time": "sample", "lead_campaign_status": "valid", "lead_campaign_status_message": "valid", "lead_connection_status": "valid", "lead_message_status": "valid", "linkedin_sender_full_name": "sample", "linkedin_sender_id": "rec_4f3a91", "linkedin_account_id": 1, "profile_first_name": "sample", "profile_last_name": "sample", "profile_headline": "sample", "profile_about": "sample", "profile_company_name": "sample", "profile_company_url": "https://acme.com", "profile_email_address": "[email protected]", "profile_connection": 1, "profile_follower": 1, "profile_image_url": "https://acme.com", "profile_location": "sample", "profile_position": "sample", "profile_url": "https://acme.com", "profile_linkedin_id": "rec_4f3a91", "total_count": 1 } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
integration
Get All Campaigns (HeyReach)
Retrieve a paginated list of all campaigns from HeyReach, with optional filters for name, status, and associated accounts.
Add Leads to Campaign (HeyReach)
Add one or more leads to an existing HeyReach campaign by ID.
List LinkedIn Accounts (HeyReach)
Retrieve a paginated collection of all LinkedIn accounts connected to your workspace.
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 → get leads from campaign (heyreach) → 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 HeyReach actions.
Get All Campaigns (HeyReach)
Retrieve a paginated list of all campaigns from HeyReach, with optional filters for name, status, and associated accounts.
Add Leads to Campaign (HeyReach)
Add one or more leads to an existing HeyReach campaign by ID.
List LinkedIn Accounts (HeyReach)
Retrieve a paginated collection of all LinkedIn accounts connected to your workspace.
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__heyreach-...` 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 Get Leads from Campaign (HeyReach) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.