Skip to main content
Server path: /apollo | Type: Application | PCID required: Yes Prospecting and enrichment

​
Tools

ToolDescription
apollo_enrich_personEnrich a person record using Apollo’s data. Find detailed information about a person by email, name, or other identifiers.
apollo_enrich_organizationEnrich an organization/company record using Apollo’s data. Get detailed company information by domain.
apollo_search_peopleSearch for people/contacts in Apollo’s database using various filters like job titles, company, location, etc. Does not return emails or phone numbers - use People Enrichment for that.
apollo_search_organizationsSearch for organizations/companies in Apollo’s database using various filters. Consumes credits.
apollo_get_organization_infoGet complete information about a specific organization by its Apollo ID. IMPORTANT: You MUST first call apollo_search_organizations to get an organization_id. This tool does NOT accept domain names - only organization_id from search results.
apollo_create_accountCreate a new account in Apollo CRM. An account is a company your team has explicitly added. Apollo does not deduplicate - if entry has same name/domain as existing account, a new account is created.
apollo_update_accountUpdate an existing account in Apollo CRM. To find account IDs, use apollo_search_accounts first.
apollo_search_accountsSearch for accounts that have been added to your Apollo CRM. Only returns accounts in your database - use apollo_search_organizations to search the full Apollo database.
apollo_get_accountRetrieve details for an existing account in your Apollo database. To find account IDs, use apollo_search_accounts first.
apollo_list_account_stagesList all available account stages in Apollo.
apollo_create_contactCreate a new contact in Apollo CRM. By default, Apollo does not deduplicate - set run_dedupe to true to enable.
apollo_update_contactUpdate an existing contact in Apollo CRM. To find contact IDs, use apollo_search_contacts first.
apollo_search_contactsSearch for contacts in your Apollo CRM. This returns only contacts your team has added. Display limit: 50,000 records (100 per page, up to 500 pages).
apollo_get_contactRetrieve details for an existing contact in your Apollo database. Use apollo_search_contacts to find contact IDs.
apollo_list_contact_stagesList all available contact stages in Apollo.
apollo_create_dealCreate new deals/opportunities in Apollo. Deals track account activity including monetary values, owners, and stages.
apollo_update_dealUpdate an existing deal/opportunity in Apollo CRM. To find deal IDs, use apollo_list_deals first.
apollo_list_dealsList all deals/opportunities in Apollo CRM.
apollo_get_dealGet details of a specific deal by ID.
apollo_list_deal_stagesList all available deal/opportunity stages in Apollo.
apollo_create_taskCreate tasks in Apollo for you and your team. Tasks track upcoming actions like emailing or calling a contact. REQUIRED: user_id (from apollo_list_users) and contact_ids (from apollo_search_contacts). If multiple contact_ids provided, individual tasks are created for each contact.
apollo_search_tasksSearch for tasks your team has created in Apollo. Display limit: 50,000 records (100 per page, up to 500 pages).
apollo_list_usersRetrieve IDs for all users (teammates) in your Apollo account. User IDs are used in apollo_create_deal, apollo_create_account, and apollo_create_task tools.

​
apollo_enrich_person

Enrich a person record using Apollo’s data. Find detailed information about a person by email, name, or other identifiers. Parameters:
ParameterTypeRequiredDefaultDescription
first_namestringNo—First name of the person. Typically used in combination with last_name
last_namestringNo—Last name of the person. Typically used in combination with first_name
namestringNo—Full name of the person. If provided, you do not need to use first_name and last_name
emailstringNo—Email address of the person to enrich
hashed_emailstringNo—SHA256 hashed email. Use either this OR email, not both
organization_namestringNo—Name of the person’s employer. Can be current or previous employer
domainstringNo—Domain name for the person’s employer (e.g., “microsoft.com”)
apollo_person_idstringNo—Apollo ID for the person. Each person in Apollo database is assigned a unique ID
linkedin_urlstringNo—LinkedIn URL for the person (e.g., “https://www.linkedin.com/in/john-doe”)
reveal_personal_emailsbooleanNofalseSet to true to enrich the person’s data with personal emails. Requires credits
reveal_phone_numberbooleanNofalseSet to true to enrich the person’s data with phone numbers. Requires credits
webhook_urlstringNo—Required if reveal_phone_number is true. URL where Apollo sends the phone number response. Use UTF-8 encoding if needed

​
apollo_enrich_organization

Enrich an organization/company record using Apollo’s data. Get detailed company information by domain. Parameters:
ParameterTypeRequiredDefaultDescription
domainstringYes—Company domain to enrich (e.g., “apollo.io”)

​
apollo_search_people

Search for people/contacts in Apollo’s database using various filters like job titles, company, location, etc. Does not return emails or phone numbers - use People Enrichment for that. Parameters:
ParameterTypeRequiredDefaultDescription
q_keywordsstringNo—Keywords to filter the results
person_titlesstring[]No—Job titles to filter by. Results include similar titles. Examples: “sales development representative”, “marketing manager”
include_similar_titlesbooleanNotrueWhether to include people with similar job titles. Set to false for exact matches only
person_senioritiesstring[]No—Seniority levels to filter by
person_locationsstring[]No—Personal locations (cities, states, countries). Examples: “california”, “ireland”, “chicago”
contact_email_statusstring[]No—Email statuses to filter by
organization_idsstring[]No—Apollo organization IDs to filter by
q_organization_domains_liststring[]No—Company domains to filter by. Up to 1,000 domains. Examples: “apollo.io”, “microsoft.com”
organization_locationsstring[]No—Company HQ locations (cities, states, countries). Examples: “texas”, “tokyo”, “spain”
organization_num_employees_rangesstring[]No—Employee count ranges. Examples: “1,10”, “11,50”, “51,200”, “201,500”, “501,1000”, “1001,2000”, “2001,5000”, “5001,10000”, “10001+“
revenue_range_minnumberNo—Minimum company revenue (no currency symbols or commas)
revenue_range_maxnumberNo—Maximum company revenue (no currency symbols or commas)
currently_using_any_of_technology_uidsstring[]No—Filter by companies using ANY of these technologies. Examples: “salesforce”, “google_analytics”
currently_using_all_of_technology_uidsstring[]No—Filter by companies using ALL of these technologies. Examples: “salesforce”, “google_analytics”
currently_not_using_any_of_technology_uidsstring[]No—Exclude companies using any of these technologies. Examples: “salesforce”, “google_analytics”
q_organization_job_titlesstring[]No—Job titles from active job postings at the company. Examples: “sales manager”, “research analyst”
organization_job_locationsstring[]No—Locations of job postings at the company. Examples: “atlanta”, “rome”
organization_num_jobs_range_minnumberNo—Minimum number of active job postings
organization_num_jobs_range_maxnumberNo—Maximum number of active job postings
organization_job_posted_at_range_minstringNo—Earliest job posting date (YYYY-MM-DD format)
organization_job_posted_at_range_maxstringNo—Latest job posting date (YYYY-MM-DD format)
pagenumberNo1Page number for pagination
per_pagenumberNo25Results per page (max 100)

​
apollo_search_organizations

Search for organizations/companies in Apollo’s database using various filters. Consumes credits. Parameters:
ParameterTypeRequiredDefaultDescription
q_organization_domains_liststring[]No—Company domains to search. Up to 1,000 domains. Do not include www. or @ symbol. Examples: “apollo.io”, “microsoft.com”
organization_num_employees_rangesstring[]No—Employee count ranges. Examples: “1,10”, “250,500”, “10000,20000”
organization_locationsstring[]No—Company HQ locations (cities, states, countries). Examples: “texas”, “tokyo”, “spain”
organization_not_locationsstring[]No—Locations to exclude from results. Examples: “minnesota”, “ireland”, “seoul”
revenue_range_minnumberNo—Minimum company revenue (no currency symbols or commas). Example: 300000
revenue_range_maxnumberNo—Maximum company revenue (no currency symbols or commas). Example: 50000000
currently_using_any_of_technology_uidsstring[]No—Filter by companies using any of these technologies. Use underscores for spaces. Examples: “salesforce”, “google_analytics”, “wordpress_org”
q_organization_keyword_tagsstring[]No—Keywords associated with companies. Examples: “mining”, “sales strategy”, “consulting”
q_organization_namestringNo—Company name to search. Partial matches accepted. Examples: “apollo”, “mining”
organization_idsstring[]No—Apollo organization IDs to filter by. Example: “5e66b6381e05b4008c8331b8”
latest_funding_amount_range_minnumberNo—Minimum amount from most recent funding round. Example: 5000000
latest_funding_amount_range_maxnumberNo—Maximum amount from most recent funding round. Example: 15000000
total_funding_range_minnumberNo—Minimum total funding across all rounds. Example: 50000000
total_funding_range_maxnumberNo—Maximum total funding across all rounds. Example: 350000000
latest_funding_date_range_minstringNo—Earliest date of most recent funding (YYYY-MM-DD). Example: “2025-07-25”
latest_funding_date_range_maxstringNo—Latest date of most recent funding (YYYY-MM-DD). Example: “2025-09-25”
q_organization_job_titlesstring[]No—Job titles in active postings. Examples: “sales manager”, “research analyst”
organization_job_locationsstring[]No—Locations of job postings. Examples: “atlanta”, “japan”
organization_num_jobs_range_minnumberNo—Minimum number of active job postings. Examples: 50, 500
organization_num_jobs_range_maxnumberNo—Maximum number of active job postings. Examples: 50, 500
organization_job_posted_at_range_minstringNo—Earliest job posting date (YYYY-MM-DD). Example: “2025-07-25”
organization_job_posted_at_range_maxstringNo—Latest job posting date (YYYY-MM-DD). Example: “2025-09-25”
pagenumberNo1Page number for pagination
per_pagenumberNo25Results per page (max 100)

​
apollo_get_organization_info

Get complete information about a specific organization by its Apollo ID. IMPORTANT: You MUST first call apollo_search_organizations to get an organization_id. This tool does NOT accept domain names - only organization_id from search results. Parameters:
ParameterTypeRequiredDefaultDescription
organization_idstringYes—Apollo organization ID (required). To find IDs, call apollo_search_organizations and identify the organization_id value. Example: “5e66b6381e05b4008c8331b8”

​
apollo_create_account

Create a new account in Apollo CRM. An account is a company your team has explicitly added. Apollo does not deduplicate - if entry has same name/domain as existing account, a new account is created. Parameters:
ParameterTypeRequiredDefaultDescription
namestringYes—Human-readable account name. Example: “The Irish Copywriters”
domainstringNo—Domain name for the account. Do not include www. Examples: “apollo.io”, “microsoft.com”
owner_idstringNo—ID of the account owner within your Apollo account. Use apollo_list_users tool to retrieve IDs. Example: “66302798d03b9601c7934ebf”
account_stage_idstringNo—Apollo ID for the account stage. Call apollo_list_account_stages to get IDs. If not specified, Apollo auto-assigns a stage. Example: “6095a710bd01d100a506d4b9”
phonestringNo—Primary phone number. Can be HQ, branch, or direct dial. Any format accepted. Examples: “555-303-1234”, “+44 7911 123456”
raw_addressstringNo—Corporate location (city, state, country). Apollo matches to pre-defined locations. Examples: “Belfield, Dublin 4, Ireland”, “Dallas, United States”
typed_custom_fieldsobjectNo—Custom fields as key-value pairs. Keys are custom field IDs from Apollo API. Example: {“60c39ed82bd02f01154c470a”: “2025-08-07”}

​
apollo_update_account

Update an existing account in Apollo CRM. To find account IDs, use apollo_search_accounts first. Parameters:
ParameterTypeRequiredDefaultDescription
account_idstringYes—Apollo ID of the account to update. Use apollo_search_accounts to find IDs. Example: “66e9abf95ac32901b20d1a0d”
namestringNo—Updated account name. Example: “The Fast Irish Copywriters”
domainstringNo—Updated domain name. Do not include www. Examples: “apollo.io”, “microsoft.com”
owner_idstringNo—Updated owner ID. Use apollo_list_users tool to retrieve IDs. Example: “66302798d03b9601c7934ebf”
account_stage_idstringNo—Updated account stage ID. Call apollo_list_account_stages to get IDs. Example: “61b8e913e0f4d2012e3af74e”
raw_addressstringNo—Updated corporate location (city, state, country). Examples: “Belfield, Dublin 4, Ireland”, “Dallas, United States”
phonestringNo—Updated phone number. Any format accepted. Examples: “555-303-1234”, “+44 7911 123456”
typed_custom_fieldsobjectNo—Custom fields as key-value pairs. Example: {“60c39ed82bd02f01154c470a”: “2025-08-07”}

​
apollo_search_accounts

Search for accounts that have been added to your Apollo CRM. Only returns accounts in your database - use apollo_search_organizations to search the full Apollo database. Parameters:
ParameterTypeRequiredDefaultDescription
q_organization_namestringNo—Keywords to search account names. Must match part of name. Examples: “apollo”, “microsoft”, “marketing”
account_stage_idsstring[]No—Filter by account stage IDs. Call apollo_list_account_stages to get IDs. Example: “61b8e913e0f4d2012e3af74e”
account_label_idsstring[]No—Filter by label IDs. Example: [“6095a710bd01d100a506d4ae”]
sort_by_fieldstringNo—Sort field for results
sort_ascendingbooleanNofalseSet to true for ascending order. Must be used with sort_by_field
pagenumberNo1Page number for pagination
per_pagenumberNo25Results per page (max 100)

​
apollo_get_account

Retrieve details for an existing account in your Apollo database. To find account IDs, use apollo_search_accounts first. Parameters:
ParameterTypeRequiredDefaultDescription
account_idstringYes—Apollo ID of the account to retrieve. Use apollo_search_accounts to find IDs. Example: “6518c6184f20350001a0b9c0”

​
apollo_list_account_stages

List all available account stages in Apollo.

​
apollo_create_contact

Create a new contact in Apollo CRM. By default, Apollo does not deduplicate - set run_dedupe to true to enable. Parameters:
ParameterTypeRequiredDefaultDescription
first_namestringYes—Contact first name. Example: “Tim”
last_namestringYes—Contact last name. Example: “Zheng”
organization_namestringNo—Contact’s employer company name. Example: “apollo”
titlestringNo—Job title. Example: “Software Engineer”
account_idstringNo—Apollo account ID to link this contact to a CRM account. Use apollo_search_accounts or apollo_create_account to get account IDs. Example: “63f53afe4ceeca00016bdd2f”
emailstringNo—Email address. Example: “john.smith@example.com”
website_urlstringNo—Corporate website URL. Example: “https://www.apollo.io/“
label_namesstring[]No—Lists to which the contact belongs
contact_stage_idstringNo—Apollo ID for the contact stage. Example: “6095a710bd01d100a506d4ae”
owner_idstringNo—Contact owner ID. Use apollo_list_users tool to retrieve IDs.
present_raw_addressstringNo—Personal location for the contact. Example: “Atlanta, United States”
direct_phonestringNo—Primary phone number. Example: “555-303-1234”
corporate_phonestringNo—Work/office phone number. Example: “+44 7911 123456”
mobile_phonestringNo—Mobile phone number. Example: “555-303-1234”
home_phonestringNo—Home phone number. Example: “555-303-1234”
other_phonestringNo—Alternative phone number. Example: “555-303-1234”
typed_custom_fieldsobjectNo—Custom fields object. Keys are custom field IDs from Apollo API.
run_dedupebooleanNofalseEnable deduplication to prevent duplicate contacts. Default: false

​
apollo_update_contact

Update an existing contact in Apollo CRM. To find contact IDs, use apollo_search_contacts first. Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringYes—Apollo ID of the contact to update. Use apollo_search_contacts to find IDs. Example: “66e34b81740c50074e3d1bd4”
first_namestringNo—Updated first name
last_namestringNo—Updated last name
emailstringNo—Updated email address
website_urlstringNo—Updated employer website URL. Example: “https://www.apollo.io/“
titlestringNo—Updated job title
organization_namestringNo—Updated organization name
owner_idstringNo—Updated owner ID
contact_stage_idstringNo—Updated contact stage ID
account_idstringNo—Updated account ID. Use apollo_search_accounts to find account IDs.
present_raw_addressstringNo—Updated present raw address
direct_phonestringNo—Updated direct phone
corporate_phonestringNo—Updated corporate phone
mobile_phonestringNo—Updated mobile phone
home_phonestringNo—Updated home phone
other_phonestringNo—Updated other phone
label_namesstring[]No—Updated label names
typed_custom_fieldsobjectNo—Updated custom fields

​
apollo_search_contacts

Search for contacts in your Apollo CRM. This returns only contacts your team has added. Display limit: 50,000 records (100 per page, up to 500 pages). Parameters:
ParameterTypeRequiredDefaultDescription
q_keywordsstringNo—Keywords to search (names, job titles, employers, emails). Examples: “tim zheng”, “senior research analyst”, “microsoft”
contact_stage_idsstring[]No—Filter by contact stage IDs. Call apollo_list_contact_stages to get IDs. Example: [“6095a710bd01d100a506d4ae”]
contact_label_idsstring[]No—Filter by contact label IDs. Example: [“6095a710bd01d100a506d4ae”]
owner_idstringNo—Filter by owner ID
account_idsstring[]No—Filter by account IDs
sort_by_fieldstringNo—Field to sort results by
sort_ascendingbooleanNofalseSort order: true for ascending, false for descending
pagenumberNo1Page number (max 500)
per_pagenumberNo25Results per page (max 100). Example: 10

​
apollo_get_contact

Retrieve details for an existing contact in your Apollo database. Use apollo_search_contacts to find contact IDs. Parameters:
ParameterTypeRequiredDefaultDescription
contact_idstringYes—Apollo ID of the contact to retrieve. Use apollo_search_contacts to find IDs. Example: “66e34b81740c50074e3d1bd4”

​
apollo_list_contact_stages

List all available contact stages in Apollo.

​
apollo_create_deal

Create new deals/opportunities in Apollo. Deals track account activity including monetary values, owners, and stages. Parameters:
ParameterTypeRequiredDefaultDescription
namestringYes—Human-readable deal name. Example: “Massive Q3 Deal”
owner_idstringNo—Deal owner ID. Use apollo_list_users to get IDs. Example: “66302798d03b9601c7934ebf”
account_idstringNo—Apollo account ID (CRM account, not organization_id). Use apollo_search_accounts or apollo_create_account to get account IDs. Example: “63f53afe4ceeca00016bdd2f”
amountstringNo—Monetary value (no commas or currency symbols). Currency from account settings. Example: “55123478” results in $55,123,478
opportunity_stage_idstringNo—Deal stage ID. Use apollo_list_deal_stages to get IDs. Example: “6095a710bd01d100a506d4bd”
closed_datestringNo—Estimated close date (YYYY-MM-DD). Example: “2025-10-30”
typed_custom_fieldsobjectNo—Custom fields object. Keys are custom field IDs from Apollo API.

​
apollo_update_deal

Update an existing deal/opportunity in Apollo CRM. To find deal IDs, use apollo_list_deals first. Parameters:
ParameterTypeRequiredDefaultDescription
opportunity_idstringYes—Apollo ID of the deal to update. Use apollo_list_deals to find IDs. Example: “66e09ea8e3cfcf01b2208ec7”
namestringNo—Updated deal name
owner_idstringNo—Updated owner ID
account_idstringNo—Updated account ID. Use apollo_search_accounts to find account IDs.
amountstringNo—Updated monetary value (no commas or currency symbols)
opportunity_stage_idstringNo—Updated deal stage ID
closed_datestringNo—Updated expected close date (YYYY-MM-DD)
typed_custom_fieldsobjectNo—Updated custom fields

​
apollo_list_deals

List all deals/opportunities in Apollo CRM. Parameters:
ParameterTypeRequiredDefaultDescription
sort_by_fieldstringNo—Sort by field: amount (largest first), is_closed (closed first), is_won (won first)
pagenumberNo—Page number. Example: 4
per_pagenumberNo—Results per page. Example: 10

​
apollo_get_deal

Get details of a specific deal by ID. Parameters:
ParameterTypeRequiredDefaultDescription
opportunity_idstringYes—ID of the deal to retrieve. Use apollo_list_deals to find IDs. Example: “66e09ea8e3cfcf01b2208ec7”

​
apollo_list_deal_stages

List all available deal/opportunity stages in Apollo.

​
apollo_create_task

Create tasks in Apollo for you and your team. Tasks track upcoming actions like emailing or calling a contact. REQUIRED: user_id (from apollo_list_users) and contact_ids (from apollo_search_contacts). If multiple contact_ids provided, individual tasks are created for each contact. Parameters:
ParameterTypeRequiredDefaultDescription
user_idstringYes—ID of the task owner who will take action. Use apollo_list_users to get IDs. Example: “66302798d03b9601c7934ebf”
contact_idsstring[]Yes—Contact IDs for the task recipients. Use apollo_search_contacts to find IDs. Example: [“66e34b81740c50074e3d1bd4”]
prioritystringYes—Task priority. Example: “medium”
due_atstringYes—Due date/time in ISO 8601 format. Use UTC/GMT timezone (Z suffix) or specify timezone offset. Examples: “2025-02-15T08:10:30Z” (UTC), “2025-03-25T10:15:30+05:00” (UTC+5). For future dates, use “scheduled” status.
typestringYes—Task type. Use “action_item” for generic tasks (include note for context).
statusstringYes—Task status. Use “scheduled” for future tasks. Example: “scheduled”
notestringNo—Task description. Recommended to provide context for the task owner. Example: “This contact expressed interest in the Sequences feature specifically. Be prepared to discuss.”

​
apollo_search_tasks

Search for tasks your team has created in Apollo. Display limit: 50,000 records (100 per page, up to 500 pages). Parameters:
ParameterTypeRequiredDefaultDescription
q_keywordsstringNo—Search keywords
statusstringNo—Task status filter
prioritystringNo—Priority filter
typestringNo—Task type filter
user_idstringNo—Filter by assigned user ID
sort_by_fieldstringNo—Sort field. task_due_at: most future-dated first. task_priority: highest priority first.
open_factor_namesstring[]No—Enter “task_types” to return count of tasks by task type in faceting.task_types
pagenumberNo1Page number (max 500). Example: 4
per_pagenumberNo25Results per page (max 100). Example: 10

​
apollo_list_users

Retrieve IDs for all users (teammates) in your Apollo account. User IDs are used in apollo_create_deal, apollo_create_account, and apollo_create_task tools. Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberNo1Page number. Example: 4
per_pagenumberNo25Results per page. Example: 10