instantly-ai

name

instantly-ai

description

Instantly is an AI-powered cold email platform that automates outreach with unlimited inboxes, built-in warm-up, personalization, and analytics—designed to help teams scale email campaigns efficiently and maximize deliverability through smart scheduling, inbox rotation, and real-time performance insights. Read and write Instantly.ai data through One: campaigns, accounts, leads, blocklistentries, subsequences, emails and more, 167 actions with real parameter documentation. Use whenever the user asks to look something up in Instantly.ai, create or update a record there, or build code against the Instantly.ai API.

Instantly.ai through One

Instantly is an AI-powered cold email platform that automates outreach with unlimited inboxes, built-in warm-up, personalization, and analytics—designed to help teams scale email campaigns efficiently and maximize deliverability through smart scheduling, inbox rotation, and real-time performance insights.

One exposes Instantly.ai through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform instantly-ai if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Instantly.ai is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Instantly.ai account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Campaigns

Action	Method	Path	Action id
Get a Campaign	GET	/api/v2/campaigns/{{id}}	conn_mod_def::GJ4omH54yIA::tCuxTm1KRNmoHmULpNq46A
Get a Campaign’s Sending Status	GET	/api/v2/campaigns/{{id}}/sending-status	conn_mod_def::GJ4omSXCDO8::5zRTe7sgSKyFHO_PbG187g
Get Launched Campaigns Count	GET	/api/v2/campaigns/count-launched	conn_mod_def::GJ4onHtfzsU::KxMEk-t2Ti-tswq51SzUPg
List Campaigns	GET	/api/v2/campaigns	conn_mod_def::GJ4onWiiAPA::96kM_eShRZ-odgCetSqauA
Search Campaigns by Lead Email	GET	/api/v2/campaigns/search-by-contact	conn_mod_def::GJ4onm81H78::aIunTnTvQ7iwknZMY_kF5w
Activate (Start/Resume) a Campaign	POST	/api/v2/campaigns/{{id}}/activate	conn_mod_def::GJ4ok-2ZbxI::TSo-ZABeR1avG-g69x6oMw
Add Variables to a Campaign	POST	/api/v2/campaigns/{{id}}/variables	conn_mod_def::GJ4olGybZWI::yxdm3iWiQYSYM75pk9lKPA
Create a Campaign From a Shared Export	POST	/api/v2/campaigns/{{id}}/from-export	conn_mod_def::GJ4olZZzxwA::YHI0frZ2QQmrTrh-JjuLBA
Create Campaign	POST	/api/v2/campaigns	conn_mod_def::GJ4olOXqEeU::pIYbDeB_SXyq63zTL4kTwA
Delete a Campaign	DELETE	/api/v2/campaigns/{{id}}	conn_mod_def::GJ4olkDKK-8::ArKKwzgVS3CdR6ICxS6ViA
Duplicate a Campaign	POST	/api/v2/campaigns/{{id}}/duplicate	conn_mod_def::GJ4oluNNNGQ::JMm01baqTHGGGcKlLkw7WQ
Export a Campaign to JSON	POST

3 more Campaigns actions are available through search.

Accounts

Action	Method	Path	Action id
Get an Account by Email	GET	/api/v2/accounts/{{email}}	conn_mod_def::GJ4o9bKy0YE::nAql0E1YQ_Wp7QDekaK-AA
List Accounts	GET	/api/v2/accounts	conn_mod_def::GJ4o96O2QJw::rrHtkJRqQ9KJbx-O3aIQsw
Create an Account	POST	/api/v2/accounts	conn_mod_def::GJ4o82JUKfA::XK1M2-XsTLqs86DmcAcrkA
Delete an Account (by Email)	DELETE	/api/v2/accounts/{{email}}	conn_mod_def::GJ4o9BfSPpA::5gl4E7hFRaiTMG-R8IN0Aw
Disable Warmup for Accounts	POST	/api/v2/accounts/warmup/disable	conn_mod_def::GJ4o9KCZokw::D4oAvts-SQiJJmBnX5G9rA
Enable Warmup for Accounts	POST	/api/v2/accounts/warmup/enable	conn_mod_def::GJ4o9Ujgn8A::PRbVMUjtTLKwui5jrdcgRQ
Get Warmup Analytics for Accounts	POST	/api/v2/accounts/warmup-analytics	conn_mod_def::GJ4o9xraZto::CexkM6l5QPS0WTqlXSzObQ
Mark an Account as Fixed	POST	/api/v2/accounts/{{email}}/mark-fixed	conn_mod_def::GJ4o-Dkxp7g::iNI5YzKzT2-fkQvTAHnwOg
Move Accounts Between Workspaces	POST	/api/v2/accounts/move	conn_mod_def::GJ4oiW9voCc::woe34itdSw2F2P37k-ny9g
Patch an Account (by Email)	PATCH	/api/v2/accounts/{{email}}	conn_mod_def::GJ4oieKV_DA::XSqVw-3DSy-xCVnbHf1uZg
Pause an Account	POST	/api/v2/accounts/{{email}}/pause	conn_mod_def::GJ4oio7nGkU::Se1nS0dtQ1a-HTA9V1Y0Iw
Resume an Account (by Email)	POST	/api/v2/accounts/{{email}}/resume

1 more Accounts actions are available through search.

Leads

Action	Method	Path	Action id
Get a Lead	GET	/api/v2/leads/{{id}}	conn_mod_def::GJ4ovXgzbT4::fmvrfPfSQY2i79Nef3VfpA
Bulk Add Leads to a Campaign or List	POST	/api/v2/leads/add	conn_mod_def::GJ4ouvvg0w8::3JQl96IGQGSjNa4FYIEvJg
Bulk Assign Leads to Organization Users	POST	/api/v2/leads/bulk-assign	conn_mod_def::GJ4ou2-iC9w::p-Y-MtNNSheRpu0VtuQrEw
Bulk Delete Leads (by Campaign or List)	DELETE	/leads	conn_mod_def::GJ4ovLqGD28::Aeu2UxI6Q9y_zoWxWbOcWg
Create Lead	POST	/api/v2/leads	conn_mod_def::GJ4ou-KVANM::GrS7qQxjQN-zRjkMXv_vlQ
Delete a Lead	DELETE	/api/v2/leads/{{id}}	conn_mod_def::GJ4ovE2EBSs::hNhayd5bR-qK-pV9qIyQxA
List Leads	POST	/api/v2/leads/list	conn_mod_def::GJ4oviQMvhQ::Cq5hvfgST-6JSboDfl87pA
Merge Two Leads	POST	/leads/merge	conn_mod_def::GJ4ovsyY75k::KQjoGQeuTOy1gDOFIOxV_g
Move a Lead to a Subsequence	POST	/leads/subsequence/move	conn_mod_def::GJ4ov0qn8pw::Fi1TJr7MTZq0S6b3NxmxGg
Move Leads to a Different Campaign or List	POST	/api/v2/leads/move	conn_mod_def::GJ4ov72LJmw::QZPwJ579TnG5p7c2fLUEpQ
Patch a Lead	PATCH	/api/v2/leads/{{id}}	conn_mod_def::GJ4owGGLvTg::_C77lOaCQ1asHcxyMouvUg
Remove a Lead from a Subsequence	POST	/leads/subsequence/remove	conn_mod_def::GJ4owOFydxc::-B9lsb6RS1uc2qAui8_Tqg

1 more Leads actions are available through search.

BlockListEntries

Action	Method	Path	Action id
Download Block List Entries as CSV	GET	/api/v2/block-lists-entries/download	conn_mod_def::GJ4okctpXUQ::HvdBCsciQNCP7mIoidYyhQ
Get a Block List Entry	GET	/api/v2/block-lists-entries/{{id}}	conn_mod_def::GJ4oknKr_hs::dVwsLjLAR5SQA7YoxEyclw
List Block List Entries	GET	/api/v2/block-lists-entries	conn_mod_def::GJ4okvxJbCY::AbA8gu8OQna2c_k6Aa4iEg
Bulk Create Block List Entries	POST	/api/v2/block-lists-entries/bulk-create	conn_mod_def::GJ4oj4Ti-Z8::RZU6LMXwTpWJDbBuLG3Z0g
Bulk Delete Block List Entries	POST	/api/v2/block-lists-entries/bulk-delete	conn_mod_def::GJ4oj_ukh-w::vW-X90G5Q9my6rcge0rE8Q
Create Block List Entry	POST	/block-lists-entries	conn_mod_def::GJ4okG4JHt4::yeZvbGwEQaSBBGuEgQYoDA
Delete a Block List Entry	DELETE	/api/v2/block-lists-entries/{{id}}	conn_mod_def::GJ4okVITSWc::7i_iah_gTzyjj8EtssHwJw
Delete All Block List Entries	DELETE	/block-lists-entries	conn_mod_def::GJ4okOmLYTs::zZBkcLLqTfGaFQC_PtuVRg
Patch a Block List Entry	PATCH	/api/v2/block-lists-entries/{{id}}	conn_mod_def::GJ4ok3m7xq0::lREjYZiESWmV-47EPr1WbQ

Subsequences

Action	Method	Path	Action id
Get a Campaign Subsequence	GET	/api/v2/subsequences/{{id}}	conn_mod_def::GJ4ooenaHMY::muW01ZPfR3KqHoZwQVtMCA
Get a Subsequence’s Sending Status	GET	/api/v2/subsequences/{{id}}/sending-status	conn_mod_def::GJ4oomTEOKI::TOrZXjhkRgeRXH9Y7dSW2A
List a Campaign’s Subsequences	GET	/api/v2/subsequences	conn_mod_def::GJ4oozcAlzo::AkjMPyrfQtexFfJYFbRkag
Create a Campaign Subsequence	POST	/api/v2/subsequences	conn_mod_def::GJ4ooAtnT74::s7dYKMLAQTWjZBAuc55_XQ
Delete a Campaign Subsequence	DELETE	/api/v2/subsequences/{{id}}	conn_mod_def::GJ4ooH3qCss::YREbaXhuTmiA-kZYRFoZ-w
Duplicate a Subsequence	POST	/api/v2/subsequences/{{id}}/duplicate	conn_mod_def::GJ4ooXQaZwE::lk4JNKwRR7iX5-ghOpsG2Q
Patch a Campaign Subsequence	PATCH	/api/v2/subsequences/{{id}}	conn_mod_def::GJ4oo7gSYas::d7fxEOhCSOq3aPcLf03X_A
Pause a Subsequence	POST	/api/v2/subsequences/{{id}}/pause	conn_mod_def::GJ4opDdUT80::jV8ZtC0nSma3luTdNqNUJw
Resume a Subsequence	POST	/api/v2/subsequences/{{id}}/resume	conn_mod_def::GJ4opLuWwYE::ew_-_JvAQVuT9B6VH_YvGQ

Emails

Action	Method	Path	Action id
Count Unread Emails	GET	/api/v2/emails/unread/count	conn_mod_def::GJ4orW6VscI::7iJQtrk0RpG2ZUqsumGEoQ
Get an Email	GET	/api/v2/emails/{{id}}	conn_mod_def::GJ4or3eDLTU::OD15XHuaQxaYd89jqFFYoQ
List Emails	GET	/api/v2/emails	conn_mod_def::GJ4osDg4Wb4::arRgRVYDRO2U4pHNiLD0xw
Delete an Email	DELETE	/api/v2/emails/{{id}}	conn_mod_def::GJ4ord3SjdA::VgRObO1NTJKvbmEYEDWpug
Forward an Email	POST	/emails/forward	conn_mod_def::GJ4ortHvvrU::1MYmiS-hR2CWbeyazfWCxA
Patch an Email	PATCH	/api/v2/emails/{{id}}	conn_mod_def::GJ4osSZD7IU::YRhLdMQ9S26dPr2hcR6Jmg
Reply to an Email	POST	/api/v2/emails/reply	conn_mod_def::GJ4osaSB_mU::2PqFmeRYTOS4MAwslGbXmg
Send a Test Email via a Workspace Email Account	POST	/api/v2/emails/test	conn_mod_def::GJ4osoIrkmU::G51YmoQNROaKFRnJvpcjjw

Webhooks

Action	Method	Path	Action id
Get a Webhook	GET	/api/v2/webhooks/{{id}}	conn_mod_def::GJ4oz6hvwAA::jQgb0avfR5yy5b3_27yD6g
List Webhooks (Workspace)	GET	/api/v2/webhooks	conn_mod_def::GJ4o0LzlfLU::xUZNsvexS6S6qCUenMq7xg
Create a Webhook	POST	/api/v2/webhooks	conn_mod_def::GJ4ozsRojM4::Gaqq5GizQtOVUKtNSSZADQ
Delete a Webhook	DELETE	/api/v2/webhooks/{{id}}	conn_mod_def::GJ4ozzRRbwE::8hQOoV8VTJqUNE6OOJSnVg
Patch a Webhook	PATCH	/api/v2/webhooks/{{id}}	conn_mod_def::GJ4o0TmI6gs::5gmuDCFwTIqm9U829ZAutg
Resume a Webhook	POST	/api/v2/webhooks/{{id}}/resume	conn_mod_def::GJ4o0ak_f3Y::O2La2u65SGmaMEdjfngdqQ
Test a Webhook	POST	/api/v2/webhooks/{{id}}/test	conn_mod_def::GJ4o0lLCnd8::7og8g5IeRs6uVSC3v3DcBw

CustomTags

Action	Method	Path	Action id
Get a Custom Tag	GET	/api/v2/custom-tags/{{id}}	conn_mod_def::GJ4op4Jcpyo::wlPZv-fcR0i79Dedk7vHRA
List Custom Tags	GET	/api/v2/custom-tags	conn_mod_def::GJ4oqDwZG2Q::CHMyfxBfTw2nZYiQo4rfJw
Create a Custom Tag	POST	/custom-tags	conn_mod_def::GJ4opp_iYpY::qnkTTg0fRFapTptQmkVWNA
Delete a Custom Tag	DELETE	/api/v2/custom-tags/{{id}}	conn_mod_def::GJ4opwzt0l4::xvj4X-ugQiSARI8b3m1C_A
Patch a Custom Tag	PATCH	/api/v2/custom-tags/{{id}}	conn_mod_def::GJ4oqLS69G4::d_9kzTnnSq-8y6BYC1yHiw
Toggle Custom Tags on Resources (Accounts or Campaigns)	POST	/api/v2/custom-tags/toggle-resource	conn_mod_def::GJ4opi6wckc::lwuT7AuBQwyjJHAVe186aQ

LeadLabels

Action	Method	Path	Action id
Get a Lead Label	GET	/api/v2/lead-labels/{{id}}	conn_mod_def::GJ4owwqYgwI::-MQA09vnSbWjix_obsddcg
List Lead Labels	GET	/lead-labels	conn_mod_def::GJ4ow4_PApw::XCZixKAKRz6cBcOOHdXN3w
Create a Lead Label	POST	/lead-labels	conn_mod_def::GJ4oweSrECI::93-F9IhQTa2S2ZMGhil27g
Delete a Lead Label	DELETE	/api/v2/lead-labels/{{id}}	conn_mod_def::GJ4owmMIRQ4::0XJJOKT2SFWUrWRbPBnOCw
Patch a Lead Label	PATCH	/api/v2/lead-labels/{{id}}	conn_mod_def::GJ4oxA3kHOg::JnrfNn0TTbG23jb6H_t_jA
Test AI Reply Label Prediction	POST	/api/v2/lead-labels/ai-reply-label	conn_mod_def::GJ4oxIMg03s::2oZHEx9MR4SkDZnhwf6VUA

LeadLists

Action	Method	Path	Action id
Get a Lead List	GET	/api/v2/lead-lists/{{id}}	conn_mod_def::GJ4oxedclyc::N780Eq6VQxmF0Hpd7E_pgQ
Get a Lead List’s Verification Statistics	GET	/api/v2/lead-lists/{{id}}/verification-stats	conn_mod_def::GJ4oxpJ7feQ::-iQdASjMR8S9RlW8cPnpRQ
List Lead Lists	GET	/api/v2/lead-lists	conn_mod_def::GJ4oxyVx1qw::tC03ad3iQVKO4bsb2NgkCw
Create Lead List	POST	/lead-lists	conn_mod_def::GJ4oxPeenfE::8KxnXQmPQh-x-yaIjmCYKQ
Delete a Lead List	DELETE	/api/v2/lead-lists/{{id}}	conn_mod_def::GJ4oxWrXEq0::Y-thtLvyQTeacN15X6-0OA
Update a Lead List	PATCH	/api/v2/lead-lists/{{id}}	conn_mod_def::GJ4ox5tnwQU::Sx6HHe2fTSmibnWcG9zXcg

SupersearchEnrichment

Action	Method	Path	Action id
Get AI Enrichment In-Progress for a Resource	GET	/api/v2/supersearch-enrichment/ai/{{resourceId}}/in-progress	conn_mod_def::GJ4oy7EZwd0::_BcwBhnWRuiuDSacnQIDnw
Get Enrichment for a Resource	GET	/api/v2/supersearch-enrichment/{{resourceId}}	conn_mod_def::GJ4ozCJhirs::bww-fAUsSs2R5U_HJIuoYQ
Count Leads From SuperSearch (Without Enrichment)	POST	/supersearch-enrichment/count-leads-from-supersearch	conn_mod_def::GJ4oyaYbE3M::yxFArEvESGKHCG7Zx2-1Uw

3 more SupersearchEnrichment actions are available through search.

This lists 90 of 167 actions. For anything not here, call search_one_platform_actions with platform instantly-ai. The full catalog is at https://www.withone.ai/knowledge/instantly-ai.

When a call fails

The error comes from Instantly.ai, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/instantly-ai

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.