Mandala
Tools

Apollo

Search, enrich, and manage contacts with Apollo.io

Usage Instructions

Integrates Apollo.io into the workflow. Search for people and companies, enrich contact data, manage your CRM contacts and accounts, add contacts to sequences, and create tasks.

Tools

Search Apollo's database for people using demographic filters

Input

ParameterTypeRequiredDescription
person_titlesarrayNoJob titles to search for (e.g., ["CEO", "VP of Sales"])
person_locationsarrayNoLocations to search in (e.g., ["San Francisco, CA", "New York, NY"])
person_senioritiesarrayNoSeniority levels (e.g., ["senior", "executive", "manager"])
organization_namesarrayNoCompany names to search within
q_keywordsstringNoKeywords to search for
pagenumberNoPage number for pagination (default: 1)
per_pagenumberNoResults per page (default: 25, max: 100)

Output

ParameterTypeDescription
peoplejsonArray of people matching the search criteria
metadatajsonPagination information including page, per_page, and total_entries

apollo_people_enrich

Enrich data for a single person using Apollo

Input

ParameterTypeRequiredDescription
first_namestringNoFirst name of the person
last_namestringNoLast name of the person
emailstringNoEmail address of the person
organization_namestringNoCompany name where the person works
domainstringNoCompany domain (e.g., apollo.io)
linkedin_urlstringNoLinkedIn profile URL
reveal_personal_emailsbooleanNoReveal personal email addresses (uses credits)
reveal_phone_numberbooleanNoReveal phone numbers (uses credits)

Output

ParameterTypeDescription
personjsonEnriched person data from Apollo
metadatajsonEnrichment metadata including enriched status

apollo_people_bulk_enrich

Enrich data for up to 10 people at once using Apollo

Input

ParameterTypeRequiredDescription
peoplearrayYesArray of people to enrich (max 10)
reveal_personal_emailsbooleanNoReveal personal email addresses (uses credits)
reveal_phone_numberbooleanNoReveal phone numbers (uses credits)

Output

ParameterTypeDescription
peoplejsonArray of enriched people data
metadatajsonBulk enrichment metadata including total and enriched counts

Search Apollo's database for companies using filters

Input

ParameterTypeRequiredDescription
organization_locationsarrayNoCompany locations to search
organization_num_employees_rangesarrayNoEmployee count ranges (e.g., ["1-10", "11-50"])
q_organization_keyword_tagsarrayNoIndustry or keyword tags
q_organization_namestringNoOrganization name to search for
pagenumberNoPage number for pagination
per_pagenumberNoResults per page (max: 100)

Output

ParameterTypeDescription
organizationsjsonArray of organizations matching the search criteria
metadatajsonPagination information including page, per_page, and total_entries

apollo_organization_enrich

Enrich data for a single organization using Apollo

Input

ParameterTypeRequiredDescription
organization_namestringNoName of the organization (at least one of organization_name or domain is required)
domainstringNoCompany domain (e.g., apollo.io) (at least one of domain or organization_name is required)

Output

ParameterTypeDescription
organizationjsonEnriched organization data from Apollo
metadatajsonEnrichment metadata including enriched status

apollo_organization_bulk_enrich

Enrich data for up to 10 organizations at once using Apollo

Input

ParameterTypeRequiredDescription
organizationsarrayYesArray of organizations to enrich (max 10)

Output

ParameterTypeDescription
organizationsjsonArray of enriched organization data
metadatajsonBulk enrichment metadata including total and enriched counts

apollo_contact_create

Create a new contact in your Apollo database

Input

ParameterTypeRequiredDescription
first_namestringYesFirst name of the contact
last_namestringYesLast name of the contact
emailstringNoEmail address of the contact
titlestringNoJob title
account_idstringNoApollo account ID to associate with
owner_idstringNoUser ID of the contact owner

Output

ParameterTypeDescription
contactjsonCreated contact data from Apollo
metadatajsonCreation metadata including created status

apollo_contact_update

Update an existing contact in your Apollo database

Input

ParameterTypeRequiredDescription
contact_idstringYesID of the contact to update
first_namestringNoFirst name of the contact
last_namestringNoLast name of the contact
emailstringNoEmail address
titlestringNoJob title
account_idstringNoApollo account ID
owner_idstringNoUser ID of the contact owner

Output

ParameterTypeDescription
contactjsonUpdated contact data from Apollo
metadatajsonUpdate metadata including updated status

Search your team's contacts in Apollo

Input

ParameterTypeRequiredDescription
q_keywordsstringNoKeywords to search for
contact_stage_idsarrayNoFilter by contact stage IDs
pagenumberNoPage number for pagination
per_pagenumberNoResults per page (max: 100)

Output

ParameterTypeDescription
contactsjsonArray of contacts matching the search criteria
metadatajsonPagination information including page, per_page, and total_entries

apollo_contact_bulk_create

Create up to 100 contacts at once in your Apollo database. Supports deduplication to prevent creating duplicate contacts. Master key required.

Input

ParameterTypeRequiredDescription
contactsarrayYesArray of contacts to create (max 100). Each contact should include first_name, last_name, and optionally email, title, account_id, owner_id
run_dedupebooleanNoEnable deduplication to prevent creating duplicate contacts. When true, existing contacts are returned without modification

Output

ParameterTypeDescription
created_contactsjsonArray of newly created contacts
existing_contactsjsonArray of existing contacts (when deduplication is enabled)
metadatajsonBulk creation metadata including counts of created and existing contacts

apollo_contact_bulk_update

Update up to 100 existing contacts at once in your Apollo database. Each contact must include an id field. Master key required.

Input

ParameterTypeRequiredDescription
contactsarrayYesArray of contacts to update (max 100). Each contact must include id field, and optionally first_name, last_name, email, title, account_id, owner_id

Output

ParameterTypeDescription
updated_contactsjsonArray of successfully updated contacts
failed_contactsjsonArray of contacts that failed to update
metadatajsonBulk update metadata including counts of updated and failed contacts

apollo_account_create

Create a new account (company) in your Apollo database

Input

ParameterTypeRequiredDescription
namestringYesCompany name
website_urlstringNoCompany website URL
phonestringNoCompany phone number
owner_idstringNoUser ID of the account owner

Output

ParameterTypeDescription
accountjsonCreated account data from Apollo
metadatajsonCreation metadata including created status

apollo_account_update

Update an existing account in your Apollo database

Input

ParameterTypeRequiredDescription
account_idstringYesID of the account to update
namestringNoCompany name
website_urlstringNoCompany website URL
phonestringNoCompany phone number
owner_idstringNoUser ID of the account owner

Output

ParameterTypeDescription
accountjsonUpdated account data from Apollo
metadatajsonUpdate metadata including updated status

Search your team's accounts in Apollo. Display limit: 50,000 records (100 records per page, 500 pages max). Use filters to narrow results. Master key required.

Input

ParameterTypeRequiredDescription
q_keywordsstringNoKeywords to search for in account data
owner_idstringNoFilter by account owner user ID
account_stage_idsarrayNoFilter by account stage IDs
pagenumberNoPage number for pagination
per_pagenumberNoResults per page (max: 100)

Output

ParameterTypeDescription
accountsjsonArray of accounts matching the search criteria
metadatajsonPagination information including page, per_page, and total_entries

apollo_account_bulk_create

Create up to 100 accounts at once in your Apollo database. Note: Apollo does not apply deduplication - duplicate accounts may be created if entries share similar names or domains. Master key required.

Input

ParameterTypeRequiredDescription
accountsarrayYesArray of accounts to create (max 100). Each account should include name (required), and optionally website_url, phone, owner_id

Output

ParameterTypeDescription
created_accountsjsonArray of newly created accounts
failed_accountsjsonArray of accounts that failed to create
metadatajsonBulk creation metadata including counts of created and failed accounts

apollo_account_bulk_update

Update up to 1000 existing accounts at once in your Apollo database (higher limit than contacts!). Each account must include an id field. Master key required.

Input

ParameterTypeRequiredDescription
accountsarrayYesArray of accounts to update (max 1000). Each account must include id field, and optionally name, website_url, phone, owner_id

Output

ParameterTypeDescription
updated_accountsjsonArray of successfully updated accounts
failed_accountsjsonArray of accounts that failed to update
metadatajsonBulk update metadata including counts of updated and failed accounts

apollo_opportunity_create

Create a new deal for an account in your Apollo database (master key required)

Input

ParameterTypeRequiredDescription
namestringYesName of the opportunity/deal
account_idstringYesID of the account this opportunity belongs to
amountnumberNoMonetary value of the opportunity
stage_idstringNoID of the deal stage
owner_idstringNoUser ID of the opportunity owner
close_datestringNoExpected close date (ISO 8601 format)
descriptionstringNoDescription or notes about the opportunity

Output

ParameterTypeDescription
opportunityjsonCreated opportunity data from Apollo
metadatajsonCreation metadata including created status

Search and list all deals/opportunities in your team's Apollo account

Input

ParameterTypeRequiredDescription
q_keywordsstringNoKeywords to search for in opportunity names
account_idsarrayNoFilter by specific account IDs
stage_idsarrayNoFilter by deal stage IDs
owner_idsarrayNoFilter by opportunity owner IDs
pagenumberNoPage number for pagination
per_pagenumberNoResults per page (max: 100)

Output

ParameterTypeDescription
opportunitiesjsonArray of opportunities matching the search criteria
metadatajsonPagination information including page, per_page, and total_entries

apollo_opportunity_get

Retrieve complete details of a specific deal/opportunity by ID

Input

ParameterTypeRequiredDescription
opportunity_idstringYesID of the opportunity to retrieve

Output

ParameterTypeDescription
opportunityjsonComplete opportunity data from Apollo
metadatajsonRetrieval metadata including found status

apollo_opportunity_update

Update an existing deal/opportunity in your Apollo database

Input

ParameterTypeRequiredDescription
opportunity_idstringYesID of the opportunity to update
namestringNoName of the opportunity/deal
amountnumberNoMonetary value of the opportunity
stage_idstringNoID of the deal stage
owner_idstringNoUser ID of the opportunity owner
close_datestringNoExpected close date (ISO 8601 format)
descriptionstringNoDescription or notes about the opportunity

Output

ParameterTypeDescription
opportunityjsonUpdated opportunity data from Apollo
metadatajsonUpdate metadata including updated status

Search for sequences/campaigns in your team's Apollo account (master key required)

Input

ParameterTypeRequiredDescription
q_namestringNoSearch sequences by name
activebooleanNoFilter by active status (true for active sequences, false for inactive)
pagenumberNoPage number for pagination
per_pagenumberNoResults per page (max: 100)

Output

ParameterTypeDescription
sequencesjsonArray of sequences/campaigns matching the search criteria
metadatajsonPagination information including page, per_page, and total_entries

apollo_sequence_add_contacts

Add contacts to an Apollo sequence

Input

ParameterTypeRequiredDescription
sequence_idstringYesID of the sequence to add contacts to
contact_idsarrayYesArray of contact IDs to add to the sequence
emailer_campaign_idstringNoOptional emailer campaign ID
send_email_from_user_idstringNoUser ID to send emails from

Output

ParameterTypeDescription
contacts_addedjsonArray of contact IDs added to the sequence
metadatajsonSequence metadata including sequence_id and total_added count

apollo_task_create

Create a new task in Apollo

Input

ParameterTypeRequiredDescription
notestringYesTask note/description
contact_idstringNoContact ID to associate with
account_idstringNoAccount ID to associate with
due_atstringNoDue date in ISO format
prioritystringNoTask priority
typestringNoTask type

Output

ParameterTypeDescription
taskjsonCreated task data from Apollo
metadatajsonCreation metadata including created status

Search for tasks in Apollo

Input

ParameterTypeRequiredDescription
contact_idstringNoFilter by contact ID
account_idstringNoFilter by account ID
completedbooleanNoFilter by completion status
pagenumberNoPage number for pagination
per_pagenumberNoResults per page (max: 100)

Output

ParameterTypeDescription
tasksjsonArray of tasks matching the search criteria
metadatajsonPagination information including page, per_page, and total_entries

apollo_email_accounts

Get list of team's linked email accounts in Apollo

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
email_accountsjsonArray of team email accounts linked in Apollo
metadatajsonMetadata including total count of email accounts

Notes

  • Category: tools
  • Type: apollo
Apollo