Create Lead (Instantly)
Instantly → Create Lead (Instantly)
/v1/instantly-create-lead{ "campaign": "sample-value", "list_id": "sample-value", "email": "[email protected]", "first_name": "Jane", "last_name": "Doe", "company_name": "Acme, Inc.", "company_domain": "https://acme.com", "mobile_number": "sample-value", "website": "https://acme.com", "personalization": "sample-value", "assigned_to": "sample-value", "organization": "Acme, Inc.", "pl_value_lead": "sample-value", "lt_interest_status": 1, "skip_if_in_workspace": true, "skip_if_in_campaign": true, "skip_if_in_list": true, "blocklist_id": "sample-value", "verify_leads_for_lead_finder": true, "verify_leads_on_import": true }
{ "ok": true, "data": { "id": "rec_4f3a91", "campaign": "sample", "list_id": "rec_4f3a91", "email": "[email protected]", "first_name": "sample", "last_name": "sample", "company_name": "sample", "company_domain": "https://acme.com", "mobile_number": "sample", "website": "https://acme.com", "personalization": "sample", "assigned_to": "sample", "organization": "sample", "pl_value_lead": "sample", "status": "valid", "enrichment_status": "valid", "verification_status": "valid", "email_open_count": "[email protected]", "email_click_count": "[email protected]", "email_reply_count": "[email protected]", "is_website_visitor": "https://acme.com", "status_summary_domain_complete": "valid", "status_summary_last_step_id": "valid", "status_summary_last_step_from": "valid", "status_summary_last_step_timestamp_executed": "valid", "status_summary_subseq": "valid", "status_summary_subseq_step_id": "valid", "status_summary_subseq_from": "valid", "status_summary_subseq_timestamp_executed": "valid", "timestamp_created": "sample", "timestamp_updated": "sample", "timestamp_last_open": "sample", "timestamp_last_click": "sample", "timestamp_last_reply": "sample", "timestamp_last_contact": "sample", "timestamp_last_touch": "sample", "timestamp_last_interest_change": "sample", "timestamp_added_subsequence": "sample", "subsequence_id": "rec_4f3a91", "upload_method": "sample", "uploaded_by_user": "sample", "lt_interest_status": "valid", "esg_code": 1, "esp_code": 1 } }
Creates a new lead in Instantly with email, name, company, and campaign assignment.
Install
Add create lead (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-create-lead
When to use this.
The "Create Lead (Instantly)" action enables users to efficiently add new leads to the Instantly CRM platform, facilitating streamlined lead management and outreach. Key input parameters include the lead's primary email address, first name, last name, company name, and optional campaign or list ID for targeted marketing efforts. Users can also specify additional details such as phone number, website, and personalization notes to enhance engagement. The action outputs essential lead information, including unique lead ID, campaign ID, and various status metrics, which help track lead interactions and engagement levels. This action is particularly useful for sales and marketing teams looking to quickly populate their CRM with potential clients, ensuring effective follow-up and nurturing strategies. It falls under the CRM category, making it an essential tool for businesses aiming to optimize their lead generation processes.
Try it
Run a sample request.
The response is a deterministic, cached example. No live call, no credits used.
Create Lead (Instantly)
Response
Output schema.
Every field returned in `data`. Click rows to expand nested objects.
idIdstringcampaignCampaignnullablestringlist_idList IdnullablestringemailEmailstringfirst_nameFirst Namestringlast_nameLast Namestringcompany_nameCompany Namestringcompany_domainCompany Domainnullablestringmobile_numberMobile NumbernullablestringwebsiteWebsitestringpersonalizationPersonalizationnullabletextassigned_toAssigned TonullablestringorganizationOrganizationnullablestringpl_value_leadPl Value LeadnullablestringstatusStatusnumberenrichment_statusEnrichment Statusnullablenumberverification_statusVerification Statusnullablenumberemail_open_countEmail Open Countnullablenumberemail_click_countEmail Click Countnullablenumberemail_reply_countEmail Reply Countnullablenumberis_website_visitorIs Website Visitornullablebooleanstatus_summary_domain_completeStatus Summary Domain Completenullablebooleanstatus_summary_last_step_idStatus Summary Last Step Idnullablestringstatus_summary_last_step_fromStatus Summary Last Step Fromnullablestringstatus_summary_last_step_timestamp_executedStatus Summary Last Step Timestamp Executednullablestringstatus_summary_subseqStatus Summary Subseqnullableobjectstatus_summary_subseq_step_idStatus Summary Subseq Step Idnullablestringstatus_summary_subseq_fromStatus Summary Subseq Fromnullablestringstatus_summary_subseq_timestamp_executedStatus Summary Subseq Timestamp Executednullablestringtimestamp_createdTimestamp Creatednullablestringtimestamp_updatedTimestamp Updatednullablestringtimestamp_last_openTimestamp Last Opennullablestringtimestamp_last_clickTimestamp Last Clicknullablestringtimestamp_last_replyTimestamp Last Replynullablestringtimestamp_last_contactTimestamp Last Contactnullablestringtimestamp_last_touchTimestamp Last Touchnullablestringtimestamp_last_interest_changeTimestamp Last Interest Changenullablestringtimestamp_added_subsequenceTimestamp Added Subsequencenullablestringsubsequence_idSubsequence Idnullablestringupload_methodUpload Methodnullablestringuploaded_by_userUploaded By Usernullablestringlt_interest_statusLt Interest Statusnullablenumberesg_codeEsg Codenullablenumberesp_codeEsp Codenullablenumber
Integrate
Copy-pasteable snippets.
Real endpoint: https://v3-api.texau.com/api/v1/instantly-create-lead. Auth: x-api-key.
/v1/instantly-create-leadcurl -X POST 'https://v3-api.texau.com/api/v1/instantly-create-lead' \ -H 'x-api-key: $TEXAU_API_KEY' \ -H 'content-type: application/json' \ -d '{"campaign":"sample-value","list_id":"sample-value","email":"[email protected]","first_name":"Jane","last_name":"Doe","company_name":"Acme, Inc.","company_domain":"https://acme.com","mobile_number":"sample-value","website":"https://acme.com","personalization":"sample-value","assigned_to":"sample-value","organization":"Acme, Inc.","pl_value_lead":"sample-value","lt_interest_status":1,"skip_if_in_workspace":true,"skip_if_in_campaign":true,"skip_if_in_list":true,"blocklist_id":"sample-value","verify_leads_for_lead_finder":true,"verify_leads_on_import":true}'
{ "ok": true, "data": { "id": "rec_4f3a91", "campaign": "sample", "list_id": "rec_4f3a91", "email": "[email protected]", "first_name": "sample", "last_name": "sample", "company_name": "sample", "company_domain": "https://acme.com", "mobile_number": "sample", "website": "https://acme.com", "personalization": "sample", "assigned_to": "sample", "organization": "sample", "pl_value_lead": "sample", "status": "valid", "enrichment_status": "valid", "verification_status": "valid", "email_open_count": "[email protected]", "email_click_count": "[email protected]", "email_reply_count": "[email protected]", "is_website_visitor": "https://acme.com", "status_summary_domain_complete": "valid", "status_summary_last_step_id": "valid", "status_summary_last_step_from": "valid", "status_summary_last_step_timestamp_executed": "valid", "status_summary_subseq": "valid", "status_summary_subseq_step_id": "valid", "status_summary_subseq_from": "valid", "status_summary_subseq_timestamp_executed": "valid", "timestamp_created": "sample", "timestamp_updated": "sample", "timestamp_last_open": "sample", "timestamp_last_click": "sample", "timestamp_last_reply": "sample", "timestamp_last_contact": "sample", "timestamp_last_touch": "sample", "timestamp_last_interest_change": "sample", "timestamp_added_subsequence": "sample", "subsequence_id": "rec_4f3a91", "upload_method": "sample", "uploaded_by_user": "sample", "lt_interest_status": "valid", "esg_code": 1, "esp_code": 1 } }
Compose
How this fits a workflow.
The next 2 actions most operators chain after this one.
integration
List Campaigns (Instantly)
Retrieve a paginated list of Instantly.ai campaigns with optional filters such as AI SDR, status, tags, and search term.
List Leads (Instantly)
Retrieve a paginated list of leads from Instantly.ai using advanced filters, search, and campaign parameters.
Update Lead (Instantly)
Update an existing lead in Instantly by ID and return the full updated lead record.
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 → create lead (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.
List Campaigns (Instantly)
Retrieve a paginated list of Instantly.ai campaigns with optional filters such as AI SDR, status, tags, and search term.
List Leads (Instantly)
Retrieve a paginated list of leads from Instantly.ai using advanced filters, search, and campaign parameters.
Update Lead (Instantly)
Update an existing lead in Instantly by ID and return the full updated lead record.
Add Lead To Sequence (Instantly)
Adds a new lead to an Instantly campaign with specified contact details and personalization.
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 Create Lead (Instantly) in 60 seconds.
Pull your API key, paste the cURL, ship to your CRM.