Heyreach logo

Add Leads to Campaign (HeyReach)

HeyReach → Add Leads to Campaign (HeyReach)

POST/v1/heyreach-add-leads-to-campaign
texau__heyreach-add-leads-to-campaignintegration
Run in Studio →Open in MCP
cURL · api.texau.app
84ms
POST/v1/heyreach-add-leads-to-campaign
{
  "campaign_id": "sample-value",
  "linkedin_account_id": "https://www.linkedin.com/in/jane-doe",
  "first_name": "Jane",
  "last_name": "Doe",
  "email": "[email protected]",
  "profile_url": "https://acme.com",
  "location": "sample-value",
  "summary": "sample-value",
  "company_name": "Acme, Inc.",
  "position": "sample-value",
  "about": "sample-value"
}
200 Accepted
{
  "ok": true,
  "data": {
    "raw_response": "sample"
  }
}

Add one or more leads to an existing HeyReach campaign by ID.

Install

Add add leads to 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.

claude_desktop_config.json
{
  "mcpServers": {
    "texau": {
      "command": "npx",
      "args": ["-y", "@texau/mcp-server"],
      "env": { "TEXAU_API_KEY": "..." }
    }
  }
}

Tool name: texau__heyreach-add-leads-to-campaign

When to use this.

The "Add Leads to Campaign (HeyReach)" action allows users to efficiently add one or more leads to an existing HeyReach campaign using the campaign's unique ID. Key input parameters include the campaignId, which identifies the specific campaign, and optional fields such as firstName, lastName, emailAddress, and LinkedIn profile details, enabling users to provide comprehensive lead information. The action outputs a rawResponse status, confirming the success or failure of the operation. This integration is particularly useful for marketing teams looking to enhance their outreach efforts by seamlessly incorporating new leads into targeted campaigns, thus optimizing lead management and engagement strategies.

Try it

Run a sample request.

The response is a deterministic, cached example. No live call, no credits used.

Add Leads to Campaign (HeyReach)

Try it

Identifier of the HeyReach campaign to which the leads will be added.

LinkedIn account identifier associated with the lead.

First name of the lead.

Last name of the lead.

Email address of the lead.

LinkedIn profile URL of the lead.

Response is cached — no live API call.

Response

Output schema.

Every field returned in `data`. Click rows to expand nested objects.

FieldType
  • raw_response
    Raw Response
    object

Integrate

Copy-pasteable snippets.

Real endpoint: https://v3-api.texau.com/api/v1/heyreach-add-leads-to-campaign. Auth: x-api-key.

cURL · api.texau.app
84ms
POST/v1/heyreach-add-leads-to-campaign
curl -X POST 'https://v3-api.texau.com/api/v1/heyreach-add-leads-to-campaign' \
  -H 'x-api-key: $TEXAU_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"campaign_id":"sample-value","linkedin_account_id":"https://www.linkedin.com/in/jane-doe","first_name":"Jane","last_name":"Doe","email":"[email protected]","profile_url":"https://acme.com","location":"sample-value","summary":"sample-value","company_name":"Acme, Inc.","position":"sample-value","about":"sample-value"}'
200 Accepted
{
  "ok": true,
  "data": {
    "raw_response": "sample"
  }
}

Compose

How this fits a workflow.

The next 2 actions most operators chain after this one.

Add Leads to Campaign (HeyReach)→Get Leads from Campaign (HeyReach)→Get All Campaigns (HeyReach)

Output

Results land in a TexAu table.

Sample rows below.

Real result preview coming soon.

InputStatusScore
[email protected]valid96
[email protected]risky54
[email protected]invalid12

Workflow

A real example.

Trigger → add leads to campaign (heyreach) → enrich → push to your CRM. ~80 ms operator effort, the rest runs in the background.

Step 1TriggerNew row, webhook, or schedule.
Step 2Add Leads to Campaign (HeyReach)HeyReach action runs.
Step 3EnrichWaterfall fills missing fields.
Step 4Push to CRMHubSpot / Salesforce / Pipedrive.

Built for

Who runs this.

GTM EngineerRevOpsAgency

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.

CodeCauseFix
200 OKAction ran. Data in `data`.Read response.
400 Bad RequestMissing or malformed input.Validate against the input schema.
401 UnauthorizedMissing or invalid `x-api-key`.Re-issue from /api-platform.
403 ForbiddenWorkspace lacks plan tier.Upgrade or contact sales.
404 Not FoundAction key not recognized.Verify the slug.
429 Rate LimitedPer-minute or per-day cap hit.Backoff; reduce concurrency.
500 Server ErrorUnexpected TexAu issue.Retry with backoff.
502 Bad GatewayUpstream provider 5xx.Retry; we surface root cause.
504 TimeoutUpstream slower than maxLatency.Switch to `isAsync` polling.

Pricing

What it costs to run.

Light tier

Pricing tier on /pricing. Per-action credit cost is private.

Related

More HeyReach 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__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 Add Leads to Campaign (HeyReach) in 60 seconds.

Pull your API key, paste the cURL, ship to your CRM.

Start free →Read the API docs