apollo

name

apollo

description

Apollo is a sales intelligence and engagement platform that helps teams find and connect with prospects. It provides enriched contact data and automation tools to streamline outbound workflows and close more deals. Read and write Apollo data through One: accounts, contacts, emailercampaigns, opportunities, organizations, phonecalls and more, 53 actions with real parameter documentation. Use whenever the user asks to look something up in Apollo, create or update a record there, or build code against the Apollo API.

Apollo through One

Apollo is a sales intelligence and engagement platform that helps teams find and connect with prospects. It provides enriched contact data and automation tools to streamline outbound workflows and close more deals.

One exposes Apollo 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 apollo 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 Apollo 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 Apollo 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

Accounts

Action	Method	Path	Action id
View an Account	GET	/accounts/{{id}}	conn_mod_def::GJz18DDnE6w::RJhEmf4AT6mmLBVttv-7FA
Bulk Create Accounts	POST	/api/v1/accounts/bulk_create	conn_mod_def::GJz163LdMJU::hWDUX0fCQWCc5qQln6aQ0w
Bulk Update Accounts	POST	/api/v1/accounts/bulk_update	conn_mod_def::GJz16-Qfx1w::Et7L5sHASWaCMHF7t-u22w
Create an Account	POST	/api/v1/accounts	conn_mod_def::GJz17HSIaaw::BxpcIhBPQCqc82bYFpJLPg
Search for Accounts	POST	/api/v1/accounts/search	conn_mod_def::GJz17VqALZc::15ONRvevRLmLQmJzEwHJCw
Update Account Owner for Multiple Accounts	POST	/api/v1/accounts/update_owners	conn_mod_def::GJz17dbsUCc::NAEtaQ2FS5KOfbXQiAIoFg
Update Account Stage for Multiple Accounts	POST	/{{path}}	conn_mod_def::GJz17kS7cXI::rQlesMqqRm23fcXDB6t5sg
Update an Account	PATCH	/accounts/{{accountId}}	conn_mod_def::GJz17uMfKtU::H2egrgHsTZ2EeOtP8sVw1A

Contacts

Action	Method	Path	Action id
View a Contact	GET	/contacts/{{contactId}}	conn_mod_def::GJz19tvPv5w::qzMNEEDNSVS13OIq1ED71g
Bulk Create Contacts	POST	/api/v1/contacts/bulk_create	conn_mod_def::GJz18r1FsZE::nL_te5RwQDSYnheuzV7W-A
Bulk Update Contacts	POST	/api/v1/contacts/bulk_update	conn_mod_def::GJz184olw_M::Eiiv4GzITq2Y8UX3cefhuw
Create a Contact	POST	/api/v1/contacts	conn_mod_def::GJz18_qaRlg::Vlkwc7g2RQynN5-X7YAr7w
Search for Contacts	POST	/api/v1/contacts/search	conn_mod_def::GJz19OR6O7g::qWyp8pZmSAGHkOzMWXO21Q
Update a Contact	PATCH	/contacts/{{contactId}}	conn_mod_def::GJz19VR-BBs::-TZ9MOtMT-ClOwl_cnbjFw
Update Contact Owner for Multiple Contacts	POST	/api/v1/contacts/update_owners	conn_mod_def::GJz19dqvLjI::RWqP-UvATpykvKsM74wgRA
Update Contact Stage for Multiple Contacts	POST	/contacts/update_stages	conn_mod_def::GJz19m1SZm4::9f9265U9SK-wXd2ZaBkOZw

EmailerCampaigns

Action	Method	Path	Action id
Activate a Sequence (Approve a Sequence)	POST	/emailer_campaigns/{{sequenceId}}/approve	conn_mod_def::GJz2AtgLPus::Jvp7DjM3TvKQcSXkGoY70g
Add Contacts to a Sequence	POST	/emailer_campaigns/{{sequenceId}}/add_contact_ids	conn_mod_def::GJz2A8rUZLQ::BRe1mfcBRQ2suX0rLoMxnA
Archive a Sequence	POST	/emailer_campaigns/{{sequenceId}}/archive	conn_mod_def::GJz2BEEMZi4::OUkI3T59SaWn2TvPxYr2ZA
Deactivate a Sequence (Abort an Emailer Campaign)	POST	/emailer_campaigns/{{sequenceId}}/abort	conn_mod_def::GJz2BTGhsgo::eUsvQy2zTMCGy3G_Sa6UkQ
Search for Sequences	POST	/api/v1/emailer_campaigns/search	conn_mod_def::GJz2BqHQQLU::bmUbbCglQh2KqfGP0IXpOA
Update Contact Status in a Sequence	POST	/api/v1/emailer_campaigns/remove_or_stop_contact_ids	conn_mod_def::GJz2By0T4OM::n_mYkNbbRjKYBKSXO67Zig

Opportunities

Action	Method	Path	Action id
List All Deals	GET	/api/v1/opportunities/search	conn_mod_def::GJz199glI3I::R98nmt_VTwOcMDFFWZM9Pg
View a Deal	GET	/opportunities/{{opportunityId}}	conn_mod_def::GJz1-UopLJg::_t41ZTs1SR69nVVgySt8DQ
Create Deal	POST	/api/v1/opportunities	conn_mod_def::GJz190eHuuE::GL5DqXmtRaOYWM-gjcvDMw
Update a Deal	PATCH	/opportunities/{{opportunityId}}	conn_mod_def::GJz1-MANZ58::RFZ_l5ZYS329V6tc9SlYBA

Organizations

Action	Method	Path	Action id
Enrich an Organization by Domain	GET	/organizations/enrich	conn_mod_def::GJz1-vQqfEI::rFgxNc8wQFWyV5kX88UBpg
Get Complete Organization Info	GET	/organizations/{{id}}	conn_mod_def::GJz1_4R-H1E::mkjZTuSpQj2UeTG4XHzGhw
Bulk Organization Enrichment	POST	/api/v1/organizations/bulk_enrich	conn_mod_def::GJz1-cqFPTg::zjyuqfYsRWWN86YT9E1lQQ
Search Organizations (Company Search)	POST	/mixed_companies/search	conn_mod_def::GJz2AXYS8Hw::nYfwc352SyqMeSNf-v4kmQ

PhoneCalls

Action	Method	Path	Action id
Search Phone Calls	GET	/phone_calls/search	conn_mod_def::GJz18YkkJNE::M9zWHDmNQnG286mP6sR-Nw
Create Call Records	POST	/api/v1/phone_calls	conn_mod_def::GJz18NN_VLE::0lyEfAnHRNKcVO0rXwboFw
Update a Call Record	PUT	/phone_calls/{{id}}	conn_mod_def::GJz18kiyMJU::fhFTwLMuQ5uzuMS1dp3dbg

People

Action	Method	Path	Action id
Bulk People Enrichment	POST	/api/v1/people/bulk_match	conn_mod_def::GJz1-mOA1C0::XgK27YgKSKaEnZj_1TIPMg
Enrich a Person (People Enrichment)	POST	/api/v1/people/match	conn_mod_def::GJz1-5Pqiyg::USYoxmHNRM2-z8l50tKI_w
People API Search (Net-New People Prospecting)	POST	/api/v1/mixed_people/api_search	conn_mod_def::GJz2AmtsIH8::-KnLbk4nSHurCgEJXsodwA

Tasks

Action	Method	Path	Action id
Bulk Create Tasks	POST	/api/v1/tasks/bulk_create	conn_mod_def::GJz2B7v9zxE::pXhwSRhBTQGyzVIcPEkVDQ
Create a Task	POST	/api/v1/tasks	conn_mod_def::GJz2CCrow9U::TGx2GiD5Sky06_7b6RdTRw
Search for Tasks	POST	/api/v1/tasks/search	conn_mod_def::GJz2CLiwP_c::GRQySUEsRaKzCNgUXEYfYg

Fields

Action	Method	Path	Action id
List Fields in an Apollo Account	GET	/api/v1/fields	conn_mod_def::GJz2PQ_d0UY::7vxfP5zqSGuz4V5NrgNW5w
Create a Custom Field	POST	/api/v1/fields	conn_mod_def::GJz1_AZMmkg::OEbbCmKHR5WWmtJsPI7uCg

EmailerMessages

Action	Method	Path	Action id
Check Email Stats for an Outreach Email	GET	/emailer_messages/{{id}}/activities	conn_mod_def::GJz2BLnrCB8::vF1TyxaBQ5myM57SgGuEQw
Search Outreach Emails	GET	/api/v1/emailer_messages/search	conn_mod_def::GJz2BiEEzJM::Y5joB8UsQTOeDh1CR3rlPQ

AccountStages

Action	Method	Path	Action id
List Account Stages	GET	/api/v1/account_stages	conn_mod_def::GJz17OH1Ejw::5FIx4c77Rla0ZizWC6Cbng

ContactStages

Action	Method	Path	Action id
List Contact Stages	GET	/api/v1/contact_stages	conn_mod_def::GJz19GW61TE::bwcPpUM7Tt2aAVTnbSzu6g

OpportunityStages

Action	Method	Path	Action id
List Deal Stages	GET	/api/v1/opportunity_stages	conn_mod_def::GJz1-Ej_fcg::7yJLozw3SZS5C-d-YUwJLg

TypedCustomFields

Action	Method	Path	Action id
List All Custom Fields (Deprecated)	GET	/api/v1/typed_custom_fields	conn_mod_def::GJz1_HOOnYE::pedD6uHST0KelyQArgDpEw

Labels

Action	Method	Path	Action id
List All Lists	GET	/api/v1/labels	conn_mod_def::GJz1_NieUjo::Tm7g46eBQxWNMASJ19Ljwg

EmailAccounts

Action	Method	Path	Action id
List Email Accounts	GET	/api/v1/email_accounts	conn_mod_def::GJz1_UrYUhs::XdIVhsobTj-KkwvfkNcH5Q

Users

Action	Method	Path	Action id
List Users (Teammates)	GET	/api/v1/users/search	conn_mod_def::GJz1_pZ0XLg::NPEBl6fhT3Sm7HFPEgavsw

UsageStats

Action	Method	Path	Action id
View API Usage Stats and Rate Limits	POST	/api/v1/usage_stats/api_usage_stats	conn_mod_def::GJz1_w5eKwQ::xGHYTAZGQhukuTqPhYsqdw

NewsArticles

Action	Method	Path	Action id
Search News Articles for Companies	POST	/news_articles/search	conn_mod_def::GJz2ABKNKRA::KYut8dhiQym3KK_YqchgsA

OrganizationJobPostings

Action	Method	Path	Action id
List an Organization’s Job Postings	GET	/organizations/{{organizationId}}/job_postings	conn_mod_def::GJz2AJUZ-YI::SBuO9bAfSQqjm4l12tdvAQ

When a call fails

The error comes from Apollo, 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/apollo

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