Apollo

Configuration

Search People

Operation

Search People

Apollo API Key*

••••••••

Job Titles

json

["CEO", "VP of Sales"]

Locations

json

["San Francisco, CA", "New York, NY"]

Company Names

json

["Company A", "Company B"]

Seniority Levels

json

["senior", "manager", "director"]

Keywords

Search keywords

Page Number

Results Per Page

25 (max: 100)

Search People (apollo_people_search)

Search Apollo

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`person_titles`	array	No	Job titles to search for (e.g., ["CEO", "VP of Sales"])
`person_locations`	array	No	Locations to search in (e.g., ["San Francisco, CA", "New York, NY"])
`person_seniorities`	array	No	Seniority levels (e.g., ["senior", "executive", "manager"])
`organization_names`	array	No	Company names to search within
`q_keywords`	string	No	Keywords to search for
`page`	number	No	Page number for pagination (default: 1)
`per_page`	number	No	Results per page (default: 25, max: 100)

Output

Parameter	Type	Description
`people`	json	Array of people matching the search criteria

Enrich Person

Operation

Enrich Person

Apollo API Key*

••••••••

First Name

First name

Last Name

Last name

email@example.com

Company Name

Company name

Domain

example.com

Reveal Personal Emails

Disabled

Reveal Phone Numbers

Disabled

Enrich Person (apollo_people_enrich)

Enrich data for a single person using Apollo

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`first_name`	string	No	First name of the person
`last_name`	string	No	Last name of the person
`email`	string	No	Email address of the person
`organization_name`	string	No	Company name where the person works
`domain`	string	No	Company domain (e.g., apollo.io)
`linkedin_url`	string	No	LinkedIn profile URL
`reveal_personal_emails`	boolean	No	Reveal personal email addresses (uses credits)
`reveal_phone_number`	boolean	No	Reveal phone numbers (uses credits)

Output

Parameter	Type	Description
`person`	json	Enriched person data from Apollo

Bulk Enrich People

Operation

Bulk Enrich People

Apollo API Key*

••••••••

Reveal Personal Emails

Disabled

Reveal Phone Numbers

Disabled

People (JSON Array)*

json

[{"first_name": "John", "last_name": "Doe", "email": "john@example.com"}]

Bulk Enrich People (apollo_people_bulk_enrich)

Enrich data for up to 10 people at once using Apollo

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`people`	array	Yes	Array of people to enrich (max 10)
`reveal_personal_emails`	boolean	No	Reveal personal email addresses (uses credits)
`reveal_phone_number`	boolean	No	Reveal phone numbers (uses credits)

Output

Parameter	Type	Description
`people`	json	Array of enriched people data

Search Organizations

Operation

Search Organizations

Apollo API Key*

••••••••

Organization Locations

json

["San Francisco, CA"]

Employee Count Ranges

json

["1-10", "11-50", "51-200"]

Keyword Tags

json

["saas", "b2b", "enterprise"]

Organization Name

Company name to search

Page Number

Results Per Page

25 (max: 100)

Search Organizations (apollo_organization_search)

Search Apollo

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`organization_locations`	array	No	Company locations to search
`organization_num_employees_ranges`	array	No	Employee count ranges (e.g., ["1-10", "11-50"])
`q_organization_keyword_tags`	array	No	Industry or keyword tags
`q_organization_name`	string	No	Organization name to search for
`page`	number	No	Page number for pagination
`per_page`	number	No	Results per page (max: 100)

Output

Parameter	Type	Description
`organizations`	json	Array of organizations matching the search criteria

Enrich Organization

Operation

Enrich Organization

Apollo API Key*

••••••••

Company Name

Company name

Domain

example.com

Enrich Organization (apollo_organization_enrich)

Enrich data for a single organization using Apollo

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`organization_name`	string	No	Name of the organization (at least one of organization_name or domain is required)
`domain`	string	No	Company domain (e.g., apollo.io) (at least one of domain or organization_name is required)

Output

Parameter	Type	Description
`organization`	json	Enriched organization data from Apollo

Bulk Enrich Organizations

Operation

Bulk Enrich Organizations

Apollo API Key*

••••••••

Organizations (JSON Array)*

json

[{"organization_name": "Company A", "domain": "companya.com"}]

Bulk Enrich Organizations (apollo_organization_bulk_enrich)

Enrich data for up to 10 organizations at once using Apollo

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`organizations`	array	Yes	Array of organizations to enrich (max 10)

Output

Parameter	Type	Description
`organizations`	json	Array of enriched organization data

Create Contact

Operation

Create Contact

Apollo API Key*

••••••••

First Name

First name

Last Name

Last name

email@example.com

Job Title

Job title

Account ID

Apollo account ID

Owner ID

Apollo user ID

Create Contact (apollo_contact_create)

Create a new contact in your Apollo database

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`first_name`	string	Yes	First name of the contact
`last_name`	string	Yes	Last name of the contact
`email`	string	No	Email address of the contact
`title`	string	No	Job title
`account_id`	string	No	Apollo account ID to associate with
`owner_id`	string	No	User ID of the contact owner

Output

Parameter	Type	Description
`contact`	json	Created contact data from Apollo

Update Contact

Operation

Update Contact

Apollo API Key*

••••••••

First Name

First name

Last Name

Last name

email@example.com

Contact ID*

Apollo contact ID

Job Title

Job title

Account ID

Apollo account ID

Owner ID

Apollo user ID

Update Contact (apollo_contact_update)

Update an existing contact in your Apollo database

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`contact_id`	string	Yes	ID of the contact to update
`first_name`	string	No	First name of the contact
`last_name`	string	No	Last name of the contact
`email`	string	No	Email address
`title`	string	No	Job title
`account_id`	string	No	Apollo account ID
`owner_id`	string	No	User ID of the contact owner

Output

Parameter	Type	Description
`contact`	json	Updated contact data from Apollo

Search Contacts

Operation

Search Contacts

Apollo API Key*

••••••••

Contact Stage IDs

json

["stage_id_1", "stage_id_2"]

Keywords

Search keywords

Page Number

Results Per Page

25 (max: 100)

Search Contacts (apollo_contact_search)

Search your team

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`q_keywords`	string	No	Keywords to search for
`contact_stage_ids`	array	No	Filter by contact stage IDs
`page`	number	No	Page number for pagination
`per_page`	number	No	Results per page (max: 100)

Output

Parameter	Type	Description
`contacts`	json	Array of contacts matching the search criteria

Bulk Create Contacts

Operation

Bulk Create Contacts

Apollo API Key*

••••••••

Contacts (JSON Array)*

json

[{"first_name": "John", "last_name": "Doe", "email": "john@example.com", "title": "CEO"}]

Run Deduplication

Disabled

Bulk Create Contacts (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

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)
`contacts`	array	Yes	Array of contacts to create (max 100). Each contact should include first_name, last_name, and optionally email, title, account_id, owner_id
`run_dedupe`	boolean	No	Enable deduplication to prevent creating duplicate contacts. When true, existing contacts are returned without modification

Output

Parameter	Type	Description
`created_contacts`	json	Array of newly created contacts
`existing_contacts`	json	Array of existing contacts (when deduplication is enabled)

Bulk Update Contacts

Operation

Bulk Update Contacts

Apollo API Key*

••••••••

Contacts (JSON Array)*

json

[{"id": "contact_id_1", "first_name": "John", "last_name": "Doe"}]

Bulk Update 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

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)
`contacts`	array	Yes	Array 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

Parameter	Type	Description
`updated_contacts`	json	Array of successfully updated contacts
`failed_contacts`	json	Array of contacts that failed to update

Create Account

Operation

Create Account

Apollo API Key*

••••••••

Owner ID

Apollo user ID

Account Name

Company name

Website URL

https://example.com

Phone Number

Company phone

Create Account (apollo_account_create)

Create a new account (company) in your Apollo database

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`name`	string	Yes	Company name
`website_url`	string	No	Company website URL
`phone`	string	No	Company phone number
`owner_id`	string	No	User ID of the account owner

Output

Parameter	Type	Description
`account`	json	Created account data from Apollo

Update Account

Operation

Update Account

Apollo API Key*

••••••••

Account ID

Apollo account ID

Owner ID

Apollo user ID

Account Name

Company name

Website URL

https://example.com

Phone Number

Company phone

Update Account (apollo_account_update)

Update an existing account in your Apollo database

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`account_id`	string	Yes	ID of the account to update
`name`	string	No	Company name
`website_url`	string	No	Company website URL
`phone`	string	No	Company phone number
`owner_id`	string	No	User ID of the account owner

Output

Parameter	Type	Description
`account`	json	Updated account data from Apollo

Search Accounts

Operation

Search Accounts

Apollo API Key*

••••••••

Owner ID

Apollo user ID

Keywords

Search keywords

Account Stage IDs

json

["stage_id_1", "stage_id_2"]

Page Number

Results Per Page

25 (max: 100)

Search Accounts (apollo_account_search)

Search your team

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)
`q_keywords`	string	No	Keywords to search for in account data
`owner_id`	string	No	Filter by account owner user ID
`account_stage_ids`	array	No	Filter by account stage IDs
`page`	number	No	Page number for pagination
`per_page`	number	No	Results per page (max: 100)

Output

Parameter	Type	Description
`accounts`	json	Array of accounts matching the search criteria

Bulk Create Accounts

Operation

Bulk Create Accounts

Apollo API Key*

••••••••

Accounts (JSON Array)*

json

[{"name": "Company A", "website_url": "https://companya.com", "phone": "+1234567890"}]

Bulk Create Accounts (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

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)
`accounts`	array	Yes	Array of accounts to create (max 100). Each account should include name (required), and optionally website_url, phone, owner_id

Output

Parameter	Type	Description
`created_accounts`	json	Array of newly created accounts
`failed_accounts`	json	Array of accounts that failed to create

Bulk Update Accounts

Operation

Bulk Update Accounts

Apollo API Key*

••••••••

Accounts (JSON Array)*

json

[{"id": "account_id_1", "name": "Updated Company Name"}]

Bulk Update 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

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)
`accounts`	array	Yes	Array of accounts to update (max 1000). Each account must include id field, and optionally name, website_url, phone, owner_id

Output

Parameter	Type	Description
`updated_accounts`	json	Array of successfully updated accounts
`failed_accounts`	json	Array of accounts that failed to update

Create Opportunity

Operation

Create Opportunity

Apollo API Key*

••••••••

Account ID

Apollo account ID

Owner ID

Apollo user ID

Opportunity Name

Opportunity name

Amount

Deal amount (e.g., 50000)

Stage ID

Opportunity stage ID

Close Date

ISO date (e.g., 2024-12-31)

Description

Opportunity description

Create Opportunity (apollo_opportunity_create)

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

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)
`name`	string	Yes	Name of the opportunity/deal
`account_id`	string	Yes	ID of the account this opportunity belongs to
`amount`	number	No	Monetary value of the opportunity
`stage_id`	string	No	ID of the deal stage
`owner_id`	string	No	User ID of the opportunity owner
`close_date`	string	No	Expected close date (ISO 8601 format)
`description`	string	No	Description or notes about the opportunity

Output

Parameter	Type	Description
`opportunity`	json	Created opportunity data from Apollo

Search Opportunities

Operation

Search Opportunities

Apollo API Key*

••••••••

Keywords

Search keywords

Account IDs

json

["account_id_1", "account_id_2"]

Stage IDs

json

["stage_id_1", "stage_id_2"]

Owner IDs

json

["user_id_1", "user_id_2"]

Page Number

Results Per Page

25 (max: 100)

Search Opportunities (apollo_opportunity_search)

Search and list all deals/opportunities in your team

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`q_keywords`	string	No	Keywords to search for in opportunity names
`account_ids`	array	No	Filter by specific account IDs
`stage_ids`	array	No	Filter by deal stage IDs
`owner_ids`	array	No	Filter by opportunity owner IDs
`page`	number	No	Page number for pagination
`per_page`	number	No	Results per page (max: 100)

Output

Parameter	Type	Description
`opportunities`	json	Array of opportunities matching the search criteria

Get Opportunity

Operation

Get Opportunity

Apollo API Key*

••••••••

Opportunity ID*

Apollo opportunity ID

Get Opportunity (apollo_opportunity_get)

Retrieve complete details of a specific deal/opportunity by ID

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`opportunity_id`	string	Yes	ID of the opportunity to retrieve

Output

Parameter	Type	Description
`opportunity`	json	Complete opportunity data from Apollo

Update Opportunity

Operation

Update Opportunity

Apollo API Key*

••••••••

Owner ID

Apollo user ID

Opportunity Name

Opportunity name

Amount

Deal amount (e.g., 50000)

Stage ID

Opportunity stage ID

Close Date

ISO date (e.g., 2024-12-31)

Description

Opportunity description

Opportunity ID*

Apollo opportunity ID

Update Opportunity (apollo_opportunity_update)

Update an existing deal/opportunity in your Apollo database

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key
`opportunity_id`	string	Yes	ID of the opportunity to update
`name`	string	No	Name of the opportunity/deal
`amount`	number	No	Monetary value of the opportunity
`stage_id`	string	No	ID of the deal stage
`owner_id`	string	No	User ID of the opportunity owner
`close_date`	string	No	Expected close date (ISO 8601 format)
`description`	string	No	Description or notes about the opportunity

Output

Parameter	Type	Description
`opportunity`	json	Updated opportunity data from Apollo

Search Sequences

Operation

Search Sequences

Apollo API Key*

••••••••

Sequence Name

Search by sequence name

Active Only

Disabled

Page Number

Results Per Page

25 (max: 100)

Search Sequences (apollo_sequence_search)

Search for sequences/campaigns in your team

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)
`q_name`	string	No	Search sequences by name
`active`	boolean	No	Filter by active status (true for active sequences, false for inactive)
`page`	number	No	Page number for pagination
`per_page`	number	No	Results per page (max: 100)

Output

Parameter	Type	Description
`sequences`	json	Array of sequences/campaigns matching the search criteria

Add to Sequence

Operation

Add to Sequence

Apollo API Key*

••••••••

Sequence ID*

Apollo sequence ID

Contact IDs (JSON Array)*

json

["contact_id_1", "contact_id_2"]

Add to Sequence (apollo_sequence_add_contacts)

Add contacts to an Apollo sequence

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)
`sequence_id`	string	Yes	ID of the sequence to add contacts to
`contact_ids`	array	Yes	Array of contact IDs to add to the sequence
`emailer_campaign_id`	string	No	Optional emailer campaign ID
`send_email_from_user_id`	string	No	User ID to send emails from

Output

Parameter	Type	Description
`contacts_added`	json	Array of contact IDs added to the sequence

Create Task

Operation

Create Task

Apollo API Key*

••••••••

Account ID

Apollo account ID

Task Note*

Task description

Due Date

ISO date (e.g., 2024-12-31T23:59:59Z)

Create Task (apollo_task_create)

Create a new task in Apollo

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)
`note`	string	Yes	Task note/description
`contact_id`	string	No	Contact ID to associate with
`account_id`	string	No	Account ID to associate with
`due_at`	string	No	Due date in ISO format
`priority`	string	No	Task priority
`type`	string	No	Task type

Output

Parameter	Type	Description
`task`	json	Created task data from Apollo

Search Tasks

Operation

Search Tasks

Apollo API Key*

••••••••

Completed

Disabled

Page Number

Results Per Page

25 (max: 100)

Search Tasks (apollo_task_search)

Search for tasks in Apollo

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)
`contact_id`	string	No	Filter by contact ID
`account_id`	string	No	Filter by account ID
`completed`	boolean	No	Filter by completion status
`page`	number	No	Page number for pagination
`per_page`	number	No	Results per page (max: 100)

Output

Parameter	Type	Description
`tasks`	json	Array of tasks matching the search criteria

Get Email Accounts

Operation

Get Email Accounts

Apollo API Key*

••••••••

Get Email Accounts (apollo_email_accounts)

Get list of team

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Apollo API key (master key required)

Output

Parameter	Type	Description
`email_accounts`	json	Array of team email accounts linked in Apollo

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.

Notes

Category: tools
Type: apollo

Apollo

On this page