Apollo
API actions for the Apollo integration.
Apollo
Automate Apollo.io: enrich people and companies, search Apollo's B2B database, and manage contacts and accounts with an API key.
Create account
Add a new account (a company your team is tracking) to your Apollo account.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name of the company |
domain | string | No | Domain of the company (e.g. apollo.io) |
phone | string | No | Primary phone number for the company |
raw_address | string | No | Company address, written as ordinary text |
Response
{
"account": {}
}Create contact
Add a new contact to your team's Apollo account.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
first_name | string | No | First name of the contact |
last_name | string | No | Last name of the contact |
email | string | No | Email address of the contact |
title | string | No | Job title of the contact |
organization_name | string | No | Name of the contact's employer |
account_id | string | No | ID of the Apollo account (company) to link the contact to |
website_url | string | No | Website URL of the contact's employer |
label_names | array | No | Names of the Apollo lists to add the contact to |
Response
{
"contact": {}
}Enrich organization
Enrich a single company by its domain.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
domain | string | Yes | Company domain to enrich (e.g. apollo.io) |
Response
{
"organization": {}
}Enrich person
Enrich a single person with Apollo data such as title, company, and (optionally) email and phone number.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
email | string | No | Email address of the person |
first_name | string | No | First name of the person |
last_name | string | No | Last name of the person |
name | string | No | Full name of the person |
organization_name | string | No | Name of the person's employer |
domain | string | No | Domain of the person's employer (e.g. apollo.io) |
reveal_personal_emails | boolean | No | Set to true to include the person's personal email addresses. This uses Apollo credits. |
reveal_phone_number | boolean | No | Set to true to include the person's phone numbers. This uses Apollo credits. |
Response
{
"person": {}
}Search contacts
Search the contacts that already exist in your Apollo account.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q_keywords | string | No | Keywords to search for, such as a name or company |
page | number | No | Page number (starts at 1) |
per_page | number | No | Results per page (1-100) |
Response
{
"contacts": [],
"pagination": {}
}Search organizations
Search Apollo's database of companies using filters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q_organization_name | string | No | Company name to search for |
organization_locations | array | No | Company headquarters locations to filter by, e.g. 'Texas' or 'Japan' |
organization_num_employees_ranges | array | No | Employee count ranges, each written as 'min,max' (e.g. '1,10' or '11,50') |
page | number | No | Page number (starts at 1) |
per_page | number | No | Results per page (1-100) |
Response
{
"organizations": [],
"pagination": {}
}Search people
Search Apollo's B2B database of people using filters. Results do not include email addresses or phone numbers — use 'Enrich person' to reveal a matched person's contact details.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
q_keywords | string | No | Keywords to search for, such as a name or job title |
person_titles | array | No | Job titles to filter by, e.g. 'CEO' or 'VP of Sales' |
person_locations | array | No | Where the people are based, e.g. 'California' or 'United Kingdom' |
organization_domains | array | No | Employer domains to filter by (e.g. apollo.io) |
page | number | No | Page number (starts at 1) |
per_page | number | No | Results per page (1-100) |
Response
{
"pagination": {},
"people": []
}Update contact
Update an existing Apollo contact by its ID.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
contact_id | string | Yes | ID of the Apollo 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 of the contact |
title | string | No | Job title of the contact |
organization_name | string | No | Name of the contact's employer |
account_id | string | No | ID of the Apollo account (company) to link the contact to |
Response
{
"contact": {}
}