Add Leads to Campaign (Smartlead)
Smartlead → Add Leads to Campaign (Smartlead)
/v1/smartlead-add-campaign-leads{ "campaign_id": "sample-value", "email": "[email protected]", "first_name": "Jane", "last_name": "Doe", "company_name": "Acme, Inc.", "title": "sample-value", "mobile_number": "sample-value", "website": "https://acme.com", "location": "sample-value", "linkedin_url": "https://acme.com" }
{ "ok": true, "data": { "ok": true, "upload_count": 1, "already_added_to_campaign": 1, "total_leads": 1, "duplicate_count": 1, "block_count": 1, "invalid_email_count": "[email protected]", "bounce_count": 1, "lead_import_stopped_count": 1, "is_lead_limit_exhausted": true } }
Add a lead to a specific Smartlead campaign and retrieve detailed import metrics.
Install
Add add leads to campaign (smartlead) 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__smartlead-add-campaign-leads
When to use this.
The "Add Leads to Campaign (Smartlead)" action allows users to efficiently add leads to a designated Smartlead campaign while retrieving detailed import metrics. Key input parameters include the unique campaign identifier (campaign_id) and the lead's email address, which is mandatory. Additional optional fields such as first name, last name, company name, job title, phone number, website, location, and LinkedIn profile enhance lead data quality. The action outputs critical metrics, including success status, upload count, duplicate and invalid email counts, and lead limit status, all represented in boolean and numeric formats. This action is particularly useful for marketing and sales teams looking to streamline lead management, track campaign performance, and ensure data integrity in their outreach efforts. It falls under the integration category, making it a vital tool for seamless CRM and marketing automation workflows.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Add Leads to Campaign (Smartlead)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
okOkbooleanupload_countUpload Countnullablenumberalready_added_to_campaignAlready Added To Campaignnumbertotal_leadsTotal Leadsnullablenumberduplicate_countDuplicate Countnullablenumberblock_countBlock Countnullablenumberinvalid_email_countInvalid Email Countnullablenumberbounce_countBounce Countnullablenumberlead_import_stopped_countLead Import Stopped Countnullablenumberis_lead_limit_exhaustedIs Lead Limit Exhaustednullableboolean
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/smartlead-add-campaign-leads. Auth: x-api-key.
/v1/smartlead-add-campaign-leadscurl -X POST 'https://v3-api.texau.com/api/v1/smartlead-add-campaign-leads' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"campaign_id":"sample-value","email":"[email protected]","first_name":"Jane","last_name":"Doe","company_name":"Acme, Inc.","title":"sample-value","mobile_number":"sample-value","website":"https://acme.com","location":"sample-value","linkedin_url":"https://acme.com"}'
{ "ok": true, "data": { "ok": true, "upload_count": 1, "already_added_to_campaign": 1, "total_leads": 1, "duplicate_count": 1, "block_count": 1, "invalid_email_count": "[email protected]", "bounce_count": 1, "lead_import_stopped_count": 1, "is_lead_limit_exhausted": true } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
integration
List Leads by Campaign ID (Smartlead)
Fetches all leads associated with a specific campaign ID in Smartlead.
integration
Update Campaign Lead (Smartlead)
Update details for a specific lead within a Smartlead campaign.
integration
List Campaigns (Smartlead)
Retrieve a list of Smartlead campaigns with their statuses, scheduling settings, and configuration details.
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 → add leads to campaign (smartlead) → 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 Smartlead actions.
integration
List Leads by Campaign ID (Smartlead)
Fetches all leads associated with a specific campaign ID in Smartlead.
integration
Update Campaign Lead (Smartlead)
Update details for a specific lead within a Smartlead campaign.
integration
List Campaigns (Smartlead)
Retrieve a list of Smartlead campaigns with their statuses, scheduling settings, and configuration details.
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__smartlead-...` 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 (Smartlead) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.