Apollo
Apollo.io is a sales intelligence and engagement platform that helps teams find prospects, enrich contact data, and automate outreach. It provides access to a large B2B database, email sequencing tools, and analytics to support lead generation and pipeline growth.
People enrichment
People enrichment is an Apollo enrichment that looks up and returns data for a single person from Apollo's database. The more information you provide, the more likely Apollo is to find the correct match. Providing only general information such as a name without a domain or email may return a 200 response with no enriched records.
By default this enrichment does not return personal emails or phone numbers — use the reveal options below to retrieve them.
Account
Select a Coldout-managed account to use shared credits, or add your own account by clickingAdd account in the dropdown and entering a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Inputs
- First name — The first name of the person (e.g. Tim). Typically used together with Last name.
- Last name — The last name of the person (e.g. Zheng). Typically used together with First name.
- Name — The full name of the person (e.g. Tim Zheng). If provided, First name and Last name are not needed.
- Email — The email address of the person (e.g. tim@apollo.io).
- Hashed email — The hashed email of the person in MD5 or SHA-256 format (e.g. 8d935115b9ff4489f2d1f9249503cadf).
- Organization name — The name of the person's current or previous employer (e.g. Apollo).
- Domain — The domain of the person's current or previous employer, without www. or @ (e.g. apollo.io).
- Apollo ID — The unique Apollo ID for the person (e.g. 587cf802f65125cad923a266). Can be found via the People search.
- LinkedIn URL — The person's LinkedIn profile URL (e.g. https://www.linkedin.com/in/tim-zheng-677ba010).
Reveal options
- Reveal personal emails — Set to true to include personal email addresses in the result. Consumes additional credits. Note: personal emails for people in GDPR-compliant regions will not be returned. Default: false.
- Reveal phone number — Set to true to include all available phone numbers including mobile numbers. Consumes additional credits. Default: false.
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
Organization enrichment
Organization enrichment is an Apollo enrichment that returns data for a single company from Apollo's database. Enriched data can include industry information, revenue, employee counts, funding round details, and corporate phone numbers and locations.
Account
Select a Coldout-managed account to use shared credits, or add your own account by clickingAdd account in the dropdown and entering a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Required inputs
- Domain — The domain of the company you want to enrich, without www. or @ (e.g. apollo.io, microsoft.com).
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
People search
People search is an Apollo enrichment that finds people in Apollo's database using a combination of filters. It does not return email addresses or phone numbers — use People enrichment to retrieve those. Results are limited to 50,000 records (100 per page, up to 500 pages). Use more filters to narrow results and access data in batches.
Account
Select a Coldout-managed account to use shared credits, or add your own account by clickingAdd account in the dropdown and entering a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Person filters
- Job titles — The job titles to search for (e.g. Sales Development Representative, Marketing Manager). A person only needs to match one title. Results also include similar titles unless "Include similar titles" is set to false.
- Include similar titles — Whether to include people with job titles similar to those specified. Set to false for strict matches only (e.g. false). Default: true.
- Seniorities — The seniority levels to filter by. A person only needs to match one level. Available options: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern. Note: results are based on current job title only — if someone was previously a Director but is now a VP, they won't appear in a Director search (e.g. director, vp).
- Person locations — The locations where people live, across cities, US states, and countries (e.g. California, Ireland, Chicago).
- Keywords — A string of words to filter results across the profile (e.g. "open source developer advocate").
- Email status — The email statuses to filter by. Options: verified, unverified, likely to engage, unavailable (e.g. verified).
Company filters
- Organization domains — The domains of the person's current or previous employer, without www. or @. Accepts up to 1,000 domains (e.g. apollo.io, microsoft.com).
- Organization IDs — The Apollo IDs of the companies to include. Find IDs via the Organization Search endpoint (e.g. 5e66b6381e05b4008c8331b8).
- Organization locations — The headquarters location of the person's current employer, across cities, US states, and countries. Results are based on HQ location only — if a company's HQ is in Boston, employees won't appear in a Chicago search (e.g. Texas, Tokyo, Spain).
- Employee count range — The headcount range of the person's current employer. Enter as min and max values (e.g. 1–10, 250–500, 10000–20000).
- Revenue range — The revenue range of the person's current employer. Enter as min and max integers without currency symbols or commas (e.g. min: 500000, max: 1500000).
Technology filters
- Using all of these technologies — Find people whose employer uses all of the specified technologies (e.g. salesforce, google_analytics). Use underscores for spaces and periods. Apollo supports 1,500+ technologies.
- Using any of these technologies — Find people whose employer uses at least one of the specified technologies (e.g. wordpress_org, hubspot).
- Not using any of these technologies — Exclude people whose employer uses any of the specified technologies (e.g. salesforce).
Job posting filters
- Active job titles — Job titles listed in active postings at the person's current employer (e.g. Sales Manager, Research Analyst).
- Job locations — Locations of active jobs being recruited for at the person's employer (e.g. Atlanta, Japan).
- Active job count range — The min and max number of active job postings at the person's employer (e.g. min: 50, max: 500).
- Job posted date range — The earliest and latest dates when jobs were posted by the person's employer (e.g. min: 2025-07-25, max: 2025-09-25).
Pagination
- Page — The page number to retrieve (e.g. 4).
- Per page — The number of results to return per page. Fewer results per page improves performance (e.g. 10).
Organization search
Organization Search is an Apollo enrichment that finds companies in Apollo's database using a combination of filters. Results are limited to 50,000 records (100 per page, up to 500 pages). Use more filters to narrow results and access data in batches.
Account
Select a Coldout-managed account to use shared credits, or add your own account by clickingAdd account in the dropdown and entering a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Company filters
- Organization domains — The domains of the companies to search for, without www. or @. Accepts up to 1,000 domains (e.g. apollo.io, microsoft.com).
- Organization name — Filter by a specific company name. Partial matches are accepted — e.g. searching "marketing" would match "NY Marketing Unlimited" but not "NY Market Analysis" (e.g. apollo, mining).
- Organization IDs — The Apollo IDs of specific companies to include. Find IDs from results returned by this endpoint (e.g. 5e66b6381e05b4008c8331b8).
- Keywords — Keywords associated with the company (e.g. mining, sales strategy, consulting).
- Employee count range — The headcount range of the company. Enter as min and max values (e.g. 1–10, 250–500, 10000–20000).
- Revenue range — The revenue range of the company. Enter as min and max integers without currency symbols or commas (e.g. min: 300000, max: 50000000).
Location filters
- Organization locations — The headquarters location of the company, across cities, US states, and countries. Results are based on HQ location only — a company with a Boston HQ won't appear in a Chicago search (e.g. Texas, Tokyo, Spain).
- Exclude locations — Exclude companies based on their headquarters location. Useful for filtering out territories you don't want to prospect (e.g. Minnesota, Ireland, Seoul).
Technology filters
- Using any of these technologies — Find companies that use at least one of the specified technologies. Use underscores for spaces and periods. Apollo supports 1,500+ technologies (e.g. salesforce, google_analytics, wordpress_org).
Funding filters
- Latest funding amount range — The min and max amount the company received in its most recent funding round. Enter without currency symbols or commas (e.g. min: 5000000, max: 15000000).
- Total funding range — The min and max amount the company has received across all funding rounds combined (e.g. min: 50000000, max: 350000000).
- Latest funding date range — The earliest and latest dates when the company received its most recent funding round (e.g. min: 2025-07-25, max: 2025-09-25).
Job posting filters
- Active job titles — Job titles listed in active postings at the company (e.g. Sales Manager, Research Analyst).
- Job locations — Locations of active jobs being recruited for at the company (e.g. Atlanta, Japan).
- Active job count range — The min and max number of active job postings at the company (e.g. min: 50, max: 500).
- Job posted date range — The earliest and latest dates when jobs were posted by the company (e.g. min: 2025-07-25, max: 2025-09-25).
Pagination
- Page — The page number to retrieve (e.g. 4).
- Per page — The number of results to return per page. Fewer results per page improves performance (e.g. 10).
Organization job postings
Organization Job Postings is an Apollo enrichment that retrieves the current active job postings for a specific company. Use this to identify companies that are growing headcount in areas that are strategically important to you. Results are limited to 10,000 records — access data in batches using pagination.
Account
Select a Coldout-managed account to use shared credits, or add your own account by clickingAdd account in the dropdown and entering a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Required inputs
- Organization ID — The Apollo ID of the company whose job postings you want to retrieve (e.g. 5e66b6381e05b4008c8331b8). Find IDs by calling the Organization Search endpoint and identifying the organization_id values.
Pagination
- Page — The page number to retrieve (e.g. 4).
- Per page — The number of results to return per page. Fewer results per page improves performance (e.g. 10).
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
News articles search
News Articles Search is an Apollo enrichment that finds news articles related to specific companies in Apollo's database. Use this to stay informed about company activity such as hires, investments, and contracts.
Account
Select a Coldout-managed account to use shared credits, or add your own account by clickingAdd account in the dropdown and entering a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Required inputs
- Organization IDs — The Apollo IDs of the companies you want to find news for (e.g. 5e66b6381e05b4008c8331b8). Find IDs by calling the Organization Search endpoint and identifying the organization_id values.
Optional filters
- Categories — Filter by news category or sub-category (e.g. hires, investment, contract). Use the Apollo news search filter to explore all available categories.
- Published date range — The earliest and latest publication dates to search within. Format as YYYY-MM-DD (e.g. min: 2025-02-15, max: 2025-05-15).
Pagination
- Page — The page number to retrieve (e.g. 4).
- Per page — The number of results to return per page. Fewer results per page improves performance (e.g. 10).
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
Create a contact
Create a Contact is an Apollo enrichment that adds a new person to your team's Apollo database. A contact is a person your team has explicitly added and enriched with data such as an email address or phone number.
Account
ClickAdd account in the dropdown and enter a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Contact details
- First name — The first name of the contact (e.g. Tim).
- Last name — The last name of the contact (e.g. Zheng).
- Title — The contact's current job title (e.g. Senior Research Analyst).
- Email — The contact's email address (e.g. tim@apollo.io).
- Present raw address — The contact's personal location (e.g. Atlanta, United States).
Company details
- Organization name — The name of the contact's employer (e.g. Apollo).
- Website URL — The company's website URL (e.g. https://www.apollo.io).
- Account ID — The Apollo ID of the account to associate this contact with (e.g. 63f53afe4ceeca00016bdd2f).
Phone numbers
- Direct phone — The contact's primary phone number (e.g. 555-303-1234).
- Corporate phone — The contact's work or office phone number (e.g. +44 7911 123456).
- Mobile phone — The contact's mobile phone number (e.g. 555-303-1234).
- Home phone — The contact's home phone number (e.g. 555-303-1234).
- Other phone — An alternative phone number (e.g. 555-303-1234).
Organisation and classification
- Label names — The lists this contact should belong to (e.g. Outbound Q1, Enterprise Prospects).
- Contact stage ID — The Apollo ID for the contact's stage in your pipeline (e.g. 6095a710bd01d100a506d4ae).
- Typed custom fields — Values for any custom fields configured in your Apollo account. Call the "Get a List of All Custom Fields" endpoint to find each field's ID and accepted data type, then pass values as key-value pairs (e.g. {"60c39ed82bd02f01154c470a": "2025-08-07"}).
Deduplication
- Run dedupe — Set to true to prevent duplicate contacts from being created. When enabled, Apollo checks for existing contacts with matching email addresses, names, or other identifying details and returns the existing contact instead of creating a new one. May slightly impact performance due to additional validation checks (e.g. true). Default: false.
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
Update a Contact
Update a Contact is an Apollo enrichment that modifies an existing contact in your team's Apollo database. Only the fields you provide will be updated — all other fields remain unchanged. To create a new contact, use the Create a contact enrichment instead.
Account
ClickAdd account in the dropdown and enter a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Required inputs
- Contact ID — the Apollo ID of the contact you want to update (e.g. 66e34b81740c50074e3d1bd4). Find contact IDs by calling the Search for Contacts endpoint and identifying the id value.
Contact details
- First name — update the contact's first name (e.g. Tim).
- Last name — update the contact's last name (e.g. Zheng).
- Title — update the contact's current job title (e.g. senior research analyst).
- Email — update the contact's email address (e.g. tim@apollo.io).
- Present raw address — update the contact's location (e.g. Atlanta, United States).
Company details
- Organization name — update the name of the contact's employer (e.g. Apollo).
- Website URL — update the company's website URL (e.g. https://www.apollo.io).
- Account ID — update the Apollo account ID associated with this contact (e.g. 63f53afe4ceeca00016bdd2f).
Phone numbers
- Direct phone — update the contact's primary phone number (e.g. 555-303-1234).
- Corporate phone — update the contact's work or office phone number (e.g. +44 7911 123456).
- Mobile phone — update the contact's mobile phone number (e.g. 555-303-1234).
- Home phone — update the contact's home phone number (e.g. 555-303-1234).
- Other phone — update an alternative phone number (e.g. 555-303-1234).
Organisation and classification
- Label names — replace the lists this contact belongs to. Note: passing new values will overwrite all existing list assignments (e.g. Outbound Q1, Enterprise prospects).
- Contact stage ID — update the Apollo ID for the contact's stage in your pipeline (e.g. 6095a710bd01d100a506d4af).
- Typed custom fields — update values for custom fields in your Apollo account. Call the "Get a list of all custom fields" endpoint to find each field's ID and accepted data type, then pass values as key-value pairs (e.g. {"60c39ed82bd02f01154c470a": "2025-08-07"}).
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
View a Contact
View a Contact is an Apollo enrichment that retrieves the full details of an existing contact in your team's Apollo database. This endpoint requires a master API key — calling it without one will return a 403 error. Refer to the Apollo documentation on creating API keys to set one up.
Account
ClickAdd account in the dropdown and enter a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Required inputs
- Contact ID — the Apollo ID of the contact you want to view (e.g. 66e34b81740c50074e3d1bd4). Find contact IDs by calling the Search for Contacts endpoint and identifying the id value.
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
Search for contacts
Search for contacts is an Apollo enrichment that searches the contacts your team has explicitly added to your Apollo account. This endpoint only returns contacts — to search the broader Apollo database for people, use the People Search enrichment instead. Results are limited to 50,000 records (100 per page, up to 500 pages). Use more filters to narrow results and access data in batches.
Account
ClickAdd account in the dropdown and enter a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Filters
- Keywords — narrow the search using names, job titles, company names, or email addresses (e.g. tim zheng, senior research analyst, microsoft).
- Contact stage IDs — the Apollo IDs of the contact stages to include. If multiple stages are provided, contacts matching any of them will be returned. Call the List Contact Stages endpoint to find available IDs (e.g. 6095a710bd01d100a506d4ae).
- Contact label IDs — the Apollo IDs of the labels to filter by. If multiple labels are provided, contacts connected to any of them will be returned (e.g. 6095a710bd01d100a506d4ae).
Sorting
- Sort by field — sort results by one of the following: contact_last_activity_date (most recent activity first), contact_email_last_opened_at (most recent email opened first), contact_email_last_clicked_at (most recent email clicked first), contact_created_at (most recently created first), or contact_updated_at (most recently updated first).
- Sort ascending — set to true to sort results in ascending order. Must be used together with "sort by field" to take effect (e.g. true). Default: false.
Pagination
- Page — the page number to retrieve (e.g. 4).
- Per page — the number of results to return per page. fewer results per page improves performance (e.g. 10).
Add contacts to a sequence
Add contacts to a sequence is an Apollo enrichment that adds contacts to existing sequences in your team's Apollo account. Only contacts (people explicitly added to your database) can be added to sequences. This endpoint requires a master API key — calling it without one will return a 403 error.
Account
ClickAdd account in the dropdown and enter a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Required inputs
- Sequence ID — the Apollo ID of the sequence you want to add contacts to (e.g. 66e9e215ece19801b219997f). Find sequence IDs by calling the Search for Sequences endpoint.
- Send email from account ID — the Apollo ID of the email account to use for sending emails to the added contacts (e.g. 6633baaece5fbd01c791d7ca). Find email account IDs via the Get a List of Email Accounts endpoint.
- Contact IDs or label names — either provide contact IDs directly (e.g. 66e34b81740c50074e3d1bd4) or provide label names to add all contacts with those labels. At least one of these must be provided.
Sending options
- Send email from address — a specific email address to send from within the selected email account (e.g. tim@apollo.io).
- User ID — the ID of the team member taking this action. The activity log will show this user as the one who added the contacts (e.g. 66302798d03b9601c7934ebf).
Contact eligibility overrides
By default, Apollo applies eligibility checks before adding contacts to a sequence. Each of the following can be set to true to override a specific check:
- No email — add contacts even if they have no email address (e.g. true). Default: false.
- Unverified email — add contacts even if their email address is unverified (e.g. true). Default: false.
- Job change — add contacts even if they have recently changed jobs (e.g. true). Default: false.
- Active in other sequences — add contacts even if they are already active or paused in another sequence (e.g. true). Default: false.
- Finished in other sequences — add contacts even if they have been marked as finished in another sequence (e.g. true). Default: false.
- Same company in same sequence — add contacts even if other contacts from the same company are already in the sequence (e.g. true). Default: false.
- Without ownership permission — add contacts even if you do not have ownership permission for them (e.g. true). Default: false.
- Add if in queue — add contacts even if they are currently queued for processing (e.g. true). Default: false.
- Skip contact verification — skip contact verification during the addition process (e.g. true). Default: false.
Scheduling
- Status — the initial status for added contacts. Set to "active" to add them immediately, or "paused" to add them in a paused state (e.g. paused).
- Auto unpause at — the date and time when paused contacts should automatically become active. Must be used together with status set to "paused". Use ISO 8601 format (e.g. 2025-09-01T09:00:00Z).
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
Update contact status in a sequence
Update contact status in a sequence is an Apollo enrichment that changes the status of contacts across one or more sequences — either marking them as finished, removing them entirely, or stopping their progress. This endpoint requires a master API key — calling it without one will return a 403 error.
Account
ClickAdd account in the dropdown and enter a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Required inputs
- Sequence IDs — the Apollo IDs of the sequences you want to update. If multiple sequences are provided, the status change will apply across all of them (e.g. 66e9e215ece19801b219997f). Find sequence IDs via the Search for Sequences endpoint.
- Contact IDs — the Apollo IDs of the contacts whose status you want to update (e.g. 66e34b81740c50074e3d1bd4). Find contact IDs via the Search for Contacts endpoint.
- Mode — the status change to apply. Options: mark_as_finished (mark contacts as having completed the sequence), remove (remove contacts from the sequence entirely), or stop (halt the contact's progress in the sequence).
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
Find people at company by job title
Find people at company by job title is an Apollo enrichment that searches for people in Apollo's database matching specific job titles at a given company domain.
Required inputs
- Job titles — the job titles to search for (e.g. sales development representative, marketing manager). A person only needs to match one title. Results also include similar titles — e.g. searching "marketing manager" may return "content marketing manager".
- Organization domains — the domain of the company to search within, without www. or @. Accepts up to 1,000 domains (e.g. apollo.io, microsoft.com).
Pagination
- Page — the page number to retrieve (e.g. 4).
- Per page — the number of results to return per page. Fewer results per page improves performance (e.g. 10).
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
Create an account
Create an account is an Apollo enrichment that adds a new company to your team's Apollo database. To update an existing account, use the Update an account enrichment instead. This endpoint requires a master API key — calling it without one will return a 403 error.
Account
ClickAdd account in the dropdown and enter a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Account details
- Name — a human-readable name for the account (e.g. The Irish Copywriters).
- Domain — the domain of the account, without www. (e.g. apollo.io, microsoft.com).
- Phone — the primary phone number for the account. Can be a headquarters, branch, or direct dial number. Apollo sanitizes phone numbers so any format is accepted (e.g. 555-303-1234, +44 7911 123456).
- Raw address — the corporate location for the account, including city, state, and country. Apollo matches the value to the closest pre-defined location (e.g. Belfield, Dublin 4, Ireland).
Assignment and classification
- Owner ID — the ID of the team member who owns this account (e.g. 66302798d03b9601c7934ebf). Find user IDs via the Get a List of Users endpoint.
- Account stage ID — the Apollo ID of the stage to assign this account to (e.g. 6095a710bd01d100a506d4b9). Find stage IDs via the List Account Stages endpoint. If not provided, Apollo assigns the account to a stage automatically based on your team's settings.
- Typed custom fields — values for custom fields in your Apollo account. Call the "Get a list of all custom fields" endpoint to find each field's ID and accepted data type, then pass values as key-value pairs (e.g. {"60c39ed82bd02f01154c470a": "2025-08-07"}).
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
Update an account
Update an account is an Apollo enrichment that modifies an existing company account in your team's Apollo database. Only the fields you provide will be updated — all other fields remain unchanged. To create a new account, use the Create an account enrichment instead. This endpoint requires a master API key — calling it without one will return a 403 error.
Account
ClickAdd account in the dropdown and enter a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Required inputs
- Account ID — the Apollo ID of the account you want to update (e.g. 66e9abf95ac32901b20d1a0d). Find account IDs via the Search for Accounts endpoint.
Account details
- Name — update the account's name (e.g. The Fast Irish Copywriters).
- Domain — update the account's domain, without www. (e.g. apollo.io, microsoft.com).
- Phone — update the primary phone number. Apollo sanitizes phone numbers so any format is accepted (e.g. 555-303-1234, +44 7911 123456).
- Raw address — update the corporate location, including city, state, and country. Apollo matches the value to the closest pre-defined location (e.g. Belfield, Dublin 4, Ireland).
Assignment and classification
- Owner ID — update the account owner by providing a different user ID (e.g. 66302798d03b9601c7934ebf). Find user IDs via the Get a List of Users endpoint.
- Account stage ID — update the stage this account is assigned to (e.g. 61b8e913e0f4d2012e3af74e). Find stage IDs via the List Account Stages endpoint. If not provided, Apollo assigns the stage automatically based on your team's settings.
- Typed custom fields — update values for custom fields in your Apollo account. Call the "Get a list of all custom fields" endpoint to find each field's ID and accepted data type, then pass values as key-value pairs (e.g. {"60c39ed82bd02f01154c470a": "2025-08-07"}).
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.
Search for accounts
Search for accounts is an Apollo enrichment that searches the company accounts your team has explicitly added to your Apollo database. This endpoint only returns accounts — to search the broader Apollo database for companies, use the Organization Search enrichment instead. Results are limited to 50,000 records (100 per page, up to 500 pages). Use more filters to narrow results and access data in batches.
Account
ClickAdd account in the dropdown and enter a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Filters
- Organization name — narrow the search by account name. Partial matches are accepted — e.g. searching "marketing" would match "NY Marketing Unlimited" but not "NY Market Analysts". Only searches account names, not other fields (e.g. apollo, microsoft).
- Account stage IDs — the Apollo IDs of the account stages to include. If multiple stages are provided, accounts matching any of them will be returned. Find stage IDs via the List Account Stages endpoint (e.g. 61b8e913e0f4d2012e3af74e).
- Account label IDs — the Apollo IDs of the labels to filter by. If multiple labels are provided, accounts connected to any of them will be returned (e.g. 6095a710bd01d100a506d4ae).
Sorting
- Sort by field — sort results by one of the following: account_last_activity_date (most recent activity first), account_created_at (most recently created first), or account_updated_at (most recently updated first).
- Sort ascending — set to true to sort results in ascending order. Must be used together with "sort by field" to take effect (e.g. true). Default: false.
Pagination
- Page — the page number to retrieve (e.g. 4).
- Per page — the number of results to return per page. Fewer results per page improves performance (e.g. 10).
View an account
View an account is an Apollo enrichment that retrieves the full details of an existing company account in your team's Apollo database. This endpoint requires a master API key — calling it without one will return a 403 error.
Account
ClickAdd account in the dropdown and enter a connection name and your API key. Your credentials are encrypted and can be removed at any time. You can manage all connected accounts — add new ones or remove existing ones — from the settings.
Required inputs
- Account ID — the Apollo ID of the account you want to view (e.g. 6518c6184f20350001a0b9c0). Find account IDs via the Search for Accounts endpoint.
Run condition
Optionally control when this enrichment runs using a formula. Describe the formula you want in plain text and click "Generate", or write your own using column references. The enrichment will only run if the formula resolves to true.
Auto-update
When enabled, the enrichment will automatically re-run whenever its input values change, keeping results up to date without manual action.
Save recipe
Clicking "Save recipe" saves all current input values as a reusable recipe. Recipes let you predefine configurations — including account, inputs, and run conditions — so you can quickly apply them to any table. All saved recipes will be available to select directly from the enrich popup.