Apollo

Learn how to use Apollo with Composio

Overview

Enum

APOLLO

Description

Apollo provides CRM and lead generation capabilities, helping businesses discover contacts, manage outreach, and track sales pipelines for consistent customer relationship development

Authentication Details

api_key
stringRequired

Actions

Adds contacts to a specified apollo email sequence by initiating an asynchronous background job and returning its details.

Action Parameters

contact_ids
arrayRequired
emailer_campaign_id
stringRequired
send_email_from_email_account_id
stringRequired
sequence_active_in_other_campaigns
boolean
sequence_finished_in_other_campaigns
boolean
sequence_id
stringRequired
sequence_job_change
boolean
sequence_no_email
boolean
sequence_unverified_email
boolean
user_id
string

Action Response

data
object
error
successful
boolean
Enriches data for up to 10 organizations simultaneously by providing a list of their base company domains (e.g., 'apollo.io', not 'www.apollo.io').

Action Parameters

domains
arrayRequired

Action Response

data
object
error
successful
boolean
Use to enrich multiple person profiles simultaneously with comprehensive data from apollo's database.

Action Parameters

details
arrayRequired
reveal_personal_emails
boolean
reveal_phone_number
boolean
webhook_url
string

Action Response

data
object
error
successful
boolean
Bulk updates the stage for specified existing apollo.io accounts, moving them to a valid new account stage.

Action Parameters

account_ids
arrayRequired
account_stage_id
stringRequired

Action Response

data
object
error
successful
boolean
Creates a new account in apollo.io; a new record is created even if a similar account exists, and provided `owner id` or `account stage id` must be valid existing ids.

Action Parameters

account_stage_id
string
domain
string
name
stringRequired
owner_id
string
phone
string
raw_address
string

Action Response

data
object
error
successful
boolean
Creates a new contact in apollo.io; use `account id` to link to an organization and `contact stage id` for sales stage, noting that apollo does not perform automatic deduplication.

Action Parameters

account_id
string
contact_stage_id
string
corporate_phone
string
direct_phone
string
email
string
first_name
stringRequired
home_phone
string
label_names
array
last_name
stringRequired
mobile_phone
string
organization_name
string
other_phone
string
present_raw_address
string
title
string
website_url
string

Action Response

data
object
error
successful
boolean
Creates a new sales opportunity (deal) in apollo.io; all provided ids (`owner id`, `account id`, `opportunity stage id`) must be valid existing apollo identifiers.

Action Parameters

account_id
string
amount
string
closed_date
string
name
stringRequired
opportunity_stage_id
string
owner_id
string

Action Response

data
object
error
successful
boolean
Creates a distinct apollo.io task for each contact id in contact ids, assigning them to user id; this action is not for free plan users and repeated calls create duplicate tasks.

Action Parameters

contact_ids
arrayRequired
due_at
stringRequired
note
string
priority
stringRequired
status
stringRequired
type
stringRequired
user_id
stringRequired

Action Response

data
object
error
successful
boolean
Retrieves all labels from apollo.io, used for organizing contacts and accounts.

Action Parameters

Action Response

data
object
error
successful
boolean
Retrieves all configured opportunity (deal) stages from the apollo.io account.

Action Parameters

Action Response

data
object
error
successful
boolean
Retrieves paginated job postings for a specified organization by its id, optionally filtering by domain; ensure `organization id` is a valid identifier.

Action Parameters

organization_id
stringRequired
page
integer
per_page
integer
q_organization_domains
string

Action Response

data
object
error
successful
boolean
Retrieves all typed custom field definitions available in the apollo.io instance, detailing their types and configurations.

Action Parameters

Action Response

data
object
error
successful
boolean
Retrieves all available apollo.io account stages, each including its unique id and name.

Action Parameters

Action Response

data
object
error
successful
boolean
Retrieves all available contact stages from an apollo account, including their unique ids and names.

Action Parameters

Action Response

data
object
error
successful
boolean
Retrieves a list of deals from apollo, using apollo's default sort order if 'sort by field' is omitted.

Action Parameters

page
integer
per_page
integer
sort_by_field
string

Action Response

data
object
error
successful
boolean
Retrieves all email accounts and their details for the authenticated user; takes no parameters.

Action Parameters

Action Response

data
object
error
successful
boolean
Retrieves a list of all users (teammates) associated with the apollo account, supporting pagination via `page` and `per page` parameters.

Action Parameters

page
integer
per_page
integer

Action Response

data
object
error
successful
boolean
Fetches comprehensive organization enrichment data from apollo.io for a given company domain; results are most meaningful if the company exists in apollo's database.

Action Parameters

domain
stringRequired

Action Response

data
object
error
successful
boolean
Enriches and retrieves information for a person from apollo.io, requiring one of: `email`, `hashed email`, `id`, `linkedin url`, or (`first name` and `last name` with `organization name` or `domain`) for matching; `webhook url` must be provided if `reveal phone number` is true.

Action Parameters

domain
string
email
string
first_name
string
hashed_email
string
id
string
last_name
string
linkedin_url
string
name
string
organization_name
string
reveal_personal_emails
boolean
reveal_phone_number
boolean
webhook_url
string

Action Response

data
object
error
successful
boolean
Searches for accounts within your existing apollo.io database using various criteria; requires a paid plan and is limited to 50,000 records.

Action Parameters

account_stage_ids
array
page
integer
per_page
integer
q_organization_name
string
sort_ascending
boolean
sort_by_field
string

Action Response

data
object
error
successful
boolean
Searches apollo contacts using keywords, stage ids (from 'list contact stages' action), or sorting (max 50,000 records; `sort ascending` requires `sort by field`).

Action Parameters

contact_stage_ids
array
page
integer
per_page
integer
q_keywords
string
sort_ascending
boolean
sort_by_field
string

Action Response

data
object
error
successful
boolean
Searches for sequences (e.g., automated email campaigns) in apollo.io.

Action Parameters

page
integerDefaults to 1
per_page
integerDefaults to 25
q_name
string

Action Response

data
object
error
successful
boolean
Searches for tasks in apollo.io using filters like keywords, date ranges (due, created, updated), priorities, types, assigned users, associated contacts/accounts, supporting sorting and pagination.

Action Parameters

account_ids
array
contact_ids
array
due_date_range
object
page
integer
per_page
integer
q_keywords
string
sort_ascending
boolean
sort_by_field
string
task_created_at_range
object
task_priorities
array
task_types
array
task_updated_at_range
object
task_user_ids
array

Action Response

data
object
error
successful
boolean
Updates specified attributes of an existing account in apollo.io.

Action Parameters

account_id
stringRequired
account_stage_id
string
domain
string
name
string
owner_id
string
phone
string
raw_address
string

Action Response

data
object
error
successful
boolean
Updates specified attributes of an existing apollo.io contact, identified by `contact id`; requires at least one other attribute to be provided for modification.

Action Parameters

account_id
string
contact_id
stringRequired
contact_stage_id
string
corporate_phone
string
direct_phone
string
email
string
first_name
string
home_phone
string
label_names
array
last_name
string
mobile_phone
string
organization_name
string
other_phone
string
present_raw_address
string
title
string
website_url
string

Action Response

data
object
error
successful
boolean
Updates the ownership of specified apollo contacts to a given apollo user, who must be part of the same team.

Action Parameters

contact_ids
arrayRequired
owner_id
stringRequired

Action Response

data
object
error
successful
boolean
Updates the stage for one or more existing contacts in apollo.io to a new valid contact stage, useful for managing sales funnel progression.

Action Parameters

contact_ids
arrayRequired
contact_stage_id
stringRequired

Action Response

data
object
error
successful
boolean
Updates a contact's status within a designated apollo sequence, but cannot set the status to 'active'.

Action Parameters

contact_id
stringRequired
sequence_id
stringRequired
status
stringRequired

Action Response

data
object
error
successful
boolean
Updates specified fields of an existing apollo.io deal (opportunity), requiring a valid `opportunity id`.

Action Parameters

account_id
string
amount
string
closed_date
string
is_closed
boolean
is_won
boolean
name
string
opportunity_id
stringRequired
opportunity_stage_id
string
owner_id
string
source
string

Action Response

data
object
error
successful
boolean