Apollo
Search, enrich, and manage contacts with Apollo.io
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.
Search Apollo
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
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 | No description |
q_keywords | string | No | No description |
page | number | No | No description |
per_page | number | No | No description |
| Parameter | Type | Description |
|---|
people | json | Array of people matching the search criteria |
page | number | Current page number |
per_page | number | Results per page |
total_entries | number | Total matching entries |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
first_name | string | No | No description |
last_name | string | No | No description |
email | string | No | No description |
organization_name | string | No | No description |
domain | string | No | Company domain (e.g., "apollo.io", "acme.com") |
linkedin_url | string | No | No description |
reveal_personal_emails | boolean | No | No description |
reveal_phone_number | boolean | No | No description |
| Parameter | Type | Description |
|---|
person | json | Enriched person data from Apollo |
enriched | boolean | Whether the person was successfully enriched |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
people | array | Yes | No description |
reveal_personal_emails | boolean | No | No description |
reveal_phone_number | boolean | No | No description |
| Parameter | Type | Description |
|---|
people | json | Array of enriched people data |
total | number | Total number of people processed |
enriched | number | Number of people successfully enriched |
Search Apollo
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
organization_locations | array | No | No description |
organization_num_employees_ranges | array | No | Employee count ranges (e.g., ["1-10", "11-50"]) |
q_organization_keyword_tags | array | No | No description |
q_organization_name | string | No | Organization name to search for (e.g., "Acme", "TechCorp") |
page | number | No | No description |
per_page | number | No | No description |
| Parameter | Type | Description |
|---|
organizations | json | Array of organizations matching the search criteria |
page | number | Current page number |
per_page | number | Results per page |
total_entries | number | Total matching entries |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
organization_name | string | No | Name of the organization (e.g., "Acme Corporation") - at least one of organization_name or domain is required |
domain | string | No | Company domain (e.g., "apollo.io", "acme.com") - at least one of domain or organization_name is required |
| Parameter | Type | Description |
|---|
organization | json | Enriched organization data from Apollo |
enriched | boolean | Whether the organization was successfully enriched |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
organizations | array | Yes | No description |
| Parameter | Type | Description |
|---|
organizations | json | Array of enriched organization data |
total | number | Total number of organizations processed |
enriched | number | Number of organizations successfully enriched |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
first_name | string | Yes | No description |
last_name | string | Yes | No description |
email | string | No | No description |
title | string | No | Job title (e.g., "VP of Sales", "Software Engineer") |
account_id | string | No | Apollo account ID to associate with (e.g., "acc_abc123") |
owner_id | string | No | No description |
| Parameter | Type | Description |
|---|
contact | json | Created contact data from Apollo |
created | boolean | Whether the contact was successfully created |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
contact_id | string | Yes | ID of the contact to update (e.g., "con_abc123") |
first_name | string | No | No description |
last_name | string | No | No description |
email | string | No | No description |
title | string | No | Job title (e.g., "VP of Sales", "Software Engineer") |
account_id | string | No | Apollo account ID (e.g., "acc_abc123") |
owner_id | string | No | No description |
| Parameter | Type | Description |
|---|
contact | json | Updated contact data from Apollo |
updated | boolean | Whether the contact was successfully updated |
Search your team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
q_keywords | string | No | No description |
contact_stage_ids | array | No | No description |
page | number | No | No description |
per_page | number | No | No description |
| Parameter | Type | Description |
|---|
contacts | json | Array of contacts matching the search criteria |
pagination | json | Pagination information |
Create up to 100 contacts at once in your Apollo database. Supports deduplication to prevent creating duplicate contacts. Master key required.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
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 |
| Parameter | Type | Description |
|---|
created_contacts | json | Array of newly created contacts |
existing_contacts | json | Array of existing contacts (when deduplication is enabled) |
total_submitted | number | Total number of contacts submitted |
created | number | Number of contacts successfully created |
existing | number | Number of existing contacts found |
Update up to 100 existing contacts at once in your Apollo database. Each contact must include an id field. Master key required.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
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 |
| Parameter | Type | Description |
|---|
updated_contacts | json | Array of successfully updated contacts |
failed_contacts | json | Array of contacts that failed to update |
total_submitted | number | Total number of contacts submitted |
updated | number | Number of contacts successfully updated |
failed | number | Number of contacts that failed to update |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
name | string | Yes | Company name (e.g., "Acme Corporation") |
website_url | string | No | No description |
phone | string | No | No description |
owner_id | string | No | No description |
| Parameter | Type | Description |
|---|
account | json | Created account data from Apollo |
created | boolean | Whether the account was successfully created |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
account_id | string | Yes | ID of the account to update (e.g., "acc_abc123") |
name | string | No | Company name (e.g., "Acme Corporation") |
website_url | string | No | No description |
phone | string | No | No description |
owner_id | string | No | No description |
| Parameter | Type | Description |
|---|
account | json | Updated account data from Apollo |
updated | boolean | Whether the account was successfully updated |
Search your team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
q_keywords | string | No | No description |
owner_id | string | No | No description |
account_stage_ids | array | No | No description |
page | number | No | No description |
per_page | number | No | No description |
| Parameter | Type | Description |
|---|
accounts | json | Array of accounts matching the search criteria |
pagination | json | Pagination information |
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.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
accounts | array | Yes | Array of accounts to create (max 100). Each account should include name (required), and optionally website_url, phone, owner_id |
| Parameter | Type | Description |
|---|
created_accounts | json | Array of newly created accounts |
failed_accounts | json | Array of accounts that failed to create |
total_submitted | number | Total number of accounts submitted |
created | number | Number of accounts successfully created |
failed | number | Number of accounts that failed to create |
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.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
accounts | array | Yes | Array of accounts to update (max 1000). Each account must include id field, and optionally name, website_url, phone, owner_id |
| Parameter | Type | Description |
|---|
updated_accounts | json | Array of successfully updated accounts |
failed_accounts | json | Array of accounts that failed to update |
total_submitted | number | Total number of accounts submitted |
updated | number | Number of accounts successfully updated |
failed | number | Number of accounts that failed to update |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
name | string | Yes | Name of the opportunity/deal (e.g., "Enterprise License - Q1") |
account_id | string | Yes | ID of the account this opportunity belongs to (e.g., "acc_abc123") |
amount | number | No | No description |
stage_id | string | No | No description |
owner_id | string | No | No description |
close_date | string | No | No description |
description | string | No | No description |
| Parameter | Type | Description |
|---|
opportunity | json | Created opportunity data from Apollo |
created | boolean | Whether the opportunity was successfully created |
Search and list all deals/opportunities in your team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
q_keywords | string | No | No description |
account_ids | array | No | Filter by specific account IDs (e.g., ["acc_123", "acc_456"]) |
stage_ids | array | No | No description |
owner_ids | array | No | No description |
page | number | No | No description |
per_page | number | No | No description |
| Parameter | Type | Description |
|---|
opportunities | json | Array of opportunities matching the search criteria |
page | number | Current page number |
per_page | number | Results per page |
total_entries | number | Total matching entries |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
opportunity_id | string | Yes | ID of the opportunity to retrieve (e.g., "opp_abc123") |
| Parameter | Type | Description |
|---|
opportunity | json | Complete opportunity data from Apollo |
found | boolean | Whether the opportunity was found |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
opportunity_id | string | Yes | ID of the opportunity to update (e.g., "opp_abc123") |
name | string | No | Name of the opportunity/deal (e.g., "Enterprise License - Q1") |
amount | number | No | No description |
stage_id | string | No | No description |
owner_id | string | No | No description |
close_date | string | No | No description |
description | string | No | No description |
| Parameter | Type | Description |
|---|
opportunity | json | Updated opportunity data from Apollo |
updated | boolean | Whether the opportunity was successfully updated |
Search for sequences/campaigns in your team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
q_name | string | No | Search sequences by name (e.g., "Outbound Q1", "Follow-up") |
active | boolean | No | No description |
page | number | No | No description |
per_page | number | No | No description |
| Parameter | Type | Description |
|---|
sequences | json | Array of sequences/campaigns matching the search criteria |
page | number | Current page number |
per_page | number | Results per page |
total_entries | number | Total matching entries |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
sequence_id | string | Yes | ID of the sequence to add contacts to (e.g., "seq_abc123") |
contact_ids | array | Yes | Array of contact IDs to add to the sequence (e.g., ["con_abc123", "con_def456"]) |
emailer_campaign_id | string | No | No description |
send_email_from_user_id | string | No | No description |
| Parameter | Type | Description |
|---|
contacts_added | json | Array of contact IDs added to the sequence |
sequence_id | string | ID of the sequence contacts were added to |
total_added | number | Total number of contacts added |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
note | string | Yes | No description |
contact_id | string | No | Contact ID to associate with (e.g., "con_abc123") |
account_id | string | No | Account ID to associate with (e.g., "acc_abc123") |
due_at | string | No | No description |
priority | string | No | No description |
type | string | No | No description |
| Parameter | Type | Description |
|---|
task | json | Created task data from Apollo |
created | boolean | Whether the task was successfully created |
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
contact_id | string | No | Filter by contact ID (e.g., "con_abc123") |
account_id | string | No | Filter by account ID (e.g., "acc_abc123") |
completed | boolean | No | No description |
page | number | No | No description |
per_page | number | No | No description |
| Parameter | Type | Description |
|---|
tasks | json | Array of tasks matching the search criteria |
pagination | json | Pagination information |
Get list of team
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | No description |
| Parameter | Type | Description |
|---|
email_accounts | json | Array of team email accounts linked in Apollo |
total | number | Total count of email accounts |