Apollo

48 tools available

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

crm sales & crm

Connect Apollo Visit Apollo ↗

Connect Apollo to Definable to enrich new leads, route deals by ICP, flag stalled opportunities. Personas call Apollo's 48 tools directly from chat or scheduled flows. Wire it to a sales persona to keep records clean, score in real-time, and surface what needs attention.

Common workflows with Apollo

Enrich every new lead

Webhook on lead create
Persona enriches with public sources
Writes back firmographic and technographic data

Auto-route hot deals

Score new opportunities by intent
Match to the closer with the right ICP
Notify both in Slack

Stall detection

Find deals with no activity in 14 days
Draft a re-engagement message per persona
Queue for sales rep approval

Apollo actions 48

Every Apollo action below is a callable tool any Definable persona can invoke.

Add Contacts to Sequence

Adds contacts to a specified Apollo email sequence and returns the contact details. `sequence_id`, `emailer_campaign_id`, and `send_email_from_email_account_id` must be retrieved from Apollo listing/search endpoints before calling this tool — these IDs cannot be inferred from names.

Bulk organization enrichment

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'). Each call consumes Apollo credits per domain enriched; monitor quota to avoid exhaustion errors.

Bulk people enrichment

Use to enrich multiple person profiles simultaneously with comprehensive data from Apollo's database. Each call consumes Apollo credits; avoid re-enriching the same contacts. Responses may include null or missing fields (e.g., email, phone, organization); treat unmatched records as valid 'no match' outcomes, not errors. Heavy use may trigger HTTP 429; respect Retry-After headers.

Bulk update account stage

Bulk updates the stage for specified existing Apollo.io accounts, moving them to a valid new account stage.

Create an Apollo account

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. The response includes the new account's ID, which can be used directly in subsequent calls.

Bulk create Apollo accounts

Creates multiple accounts in Apollo.io with a single API call (maximum 100 accounts per request). Use when creating multiple company records at once.

Bulk create Apollo contacts

Tool to bulk create multiple contacts in Apollo with a single API call. Use when you need to create multiple contacts efficiently. Supports up to 100 contacts per request with optional deduplication.

Create call record in Apollo

Tool to log call records in Apollo from external systems. Use when recording calls made through outside systems like Orum or Nooks; requires a master API key and cannot dial prospects directly.

Create Apollo contact

Creates a new contact in Apollo.io; use `account_id` to link to an organization and `contact_stage_id` for sales stage. Apollo does not auto-deduplicate — duplicate records sharing the same email are silently created; always search via APOLLO_SEARCH_CONTACTS before calling this tool. Requires explicit user confirmation before execution.

Create custom field

Creates a new custom field in Apollo.io for contacts, accounts, or opportunities. Use when you need to define additional data fields beyond Apollo's standard attributes.

Create Apollo deal

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. This action has persistent side effects — obtain explicit user confirmation before invoking.

Create Apollo Task

Tool to create a single task in Apollo.io. Use when you need to add a new task to your team's Apollo account for a specific contact. The task will be assigned to a user and includes details like type, status, priority, due date, and optional notes.

Get Account by ID

Tool to retrieve detailed information about a specific account by its Apollo ID. Use when you need to fetch complete account data including company details, contact information, and CRM integration fields.

Check Apollo API key status

Tool to check whether the provided Apollo API key is valid and accepted by Apollo (health/auth check). Use when any Apollo endpoint returns 401/403/422 to quickly diagnose invalid/expired keys versus permission scope issues. If this succeeds but other endpoints return 403, it strongly suggests permissioning or master-key scope issues rather than a totally invalid credential.

Get Apollo Contact

Retrieves detailed information about a specific contact by its ID. Use this to view contact details including name, email, phone numbers, organization, and custom fields.

Get Apollo deal

Retrieves information about a specific deal by its ID. Use this when you need to view details of a single deal.

Get Labels

Retrieves all labels from Apollo.io, used for organizing contacts and accounts. Call this before APOLLO_CREATE_CONTACT or APOLLO_UPDATE_ACCOUNT to validate label values against the returned list; mismatched labels cause 400/422 errors.

Get opportunity stages

Retrieves all configured opportunity (deal) stages from the Apollo.io account.

Get Organization by ID

Retrieves complete information about a specific organization by its Apollo ID. Use when you need detailed company data including funding, technologies, employee counts, and more.

Get Organization Job Postings

Retrieves paginated job postings for a specified organization by its ID, optionally filtering by domain; ensure `organization_id` is a valid identifier.

Get typed custom fields

Retrieves all typed custom field definitions available in the Apollo.io instance, detailing their types and configurations. Call before constructing payloads for APOLLO_UPDATE_CONTACT or APOLLO_UPDATE_ACCOUNT — mismatched types or invalid enum options cause 400 errors.

List Apollo account stages

Retrieves the IDs for all available account stages in your team's Apollo account.

List apollo contact stages

Retrieves all available contact stages from an Apollo account, including their unique IDs and names.

List Apollo deals

Retrieves a list of deals from Apollo, using Apollo's default sort order if 'sort_by_field' is omitted.

List email accounts

Retrieves all email accounts and their details for the authenticated user; takes no parameters.

List Fields

Retrieves all field definitions from Apollo.io, including system fields and custom fields. Use the optional 'source' parameter to filter by field type (system, custom, or crm_synced).

List Apollo Users

Retrieves a list of all users (teammates) associated with the Apollo account, supporting pagination via `page` and `per_page` parameters. Use this to obtain numeric user IDs required by operations like APOLLO_UPDATE_CONTACT_OWNERSHIP — names or email addresses are not accepted in place of these IDs.

Enrich organization data

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. Each call consumes Apollo credits and may be unavailable on free plans. Returns HTTP 429 under burst usage; use exponential backoff on retries.

Search organizations in Apollo

Searches Apollo's database for organizations using various filters; consumes credits on every call (unavailable on free plans) — avoid re-running identical queries and surface quota errors rather than retrying. Retrieves a maximum of 50,000 records; uses `page` (1-500) and `per_page` (1-100) for pagination — check `total_pages` in the response to iterate. Overly strict filter combinations can return zero results; start broad and narrow iteratively. Empty results and `org_not_found` are valid outcomes, not errors.

Enrich person with Apollo

Enriches and retrieves information for a person from Apollo.io. Requires one of: `id`, `email`, `hashed_email`, `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. Name-only inputs without `organization_name` or `domain` frequently return no matches.

Apollo people search

Searches Apollo's contact database for people using various filters; results capped at 50,000 records and does not enrich contact data. Combining multiple strict filters (organization_ids, person_titles, person_seniorities) can return zero results — start broad and narrow iteratively. Result records may have null email, phone, or organization fields.

Search Apollo Accounts

Searches for accounts within your existing Apollo.io database using various criteria; requires a paid plan and is limited to 50,000 records.

Search for Calls

Searches for call records in Apollo.io using filters like date range, duration, direction (inbound/outgoing), users, contacts, purposes, outcomes, and keywords. Supports pagination for efficient data retrieval.

Search Apollo contacts

Searches Apollo contacts using keywords, stage IDs (from 'List Contact Stages' action), or sorting (max 50,000 records; `sort_ascending` requires `sort_by_field`). Search before creating contacts to avoid duplicates.

Search news articles

Tool to search for news articles about companies in Apollo's database. Use when you need to find recent news, announcements, or updates about specific organizations using their Apollo IDs.

Search outreach emails

Tool to search for outreach emails sent through Apollo sequences. Use when you need to find emails created and sent by your team as part of Apollo email campaigns. This endpoint requires a master API key and has a display limit of 50,000 records (100 records per page, up to 500 pages).

Search sequences

Searches for sequences (e.g., automated email campaigns) in Apollo.io.

Search tasks

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.

Update an Apollo account

Updates specified attributes of an existing account in Apollo.io.

Update account ownership

Updates the ownership of multiple Apollo accounts to a specified user. Use when bulk assigning account ownership to a team member.

Update Apollo call record

Tool to update an existing call record in Apollo.io. Use when you need to modify details of a previously logged phone call such as duration, status, notes, or associated contact/account information.

Update Apollo contact details

Tool to update an existing contact's information in Apollo. Use when you need to modify contact details such as name, email, phone, title, organization, or custom fields. At least one field beyond contact_id must be provided.

Update contact ownership

Updates the ownership of specified Apollo contacts to a given Apollo user, who must be part of the same team.

Bulk update Apollo contacts

Tool to bulk update multiple Apollo contacts with a single API call. Use when updating multiple contacts simultaneously - either apply the same updates to all contacts using contact_ids, or apply different updates to each contact using contact_attributes. Automatically processes asynchronously for more than 100 contacts.

Update contact stage

Updates the stage for one or more existing contacts in Apollo.io to a new valid contact stage, useful for managing sales funnel progression.

Update contact status in sequence

Updates a contact's status within a designated Apollo sequence, but cannot set the status to 'active'.

Update Apollo deal

Updates specified fields of an existing Apollo.io deal (opportunity), requiring a valid `opportunity_id`.

View API Usage Stats

Fetches Apollo API usage statistics and rate limits for the connected team. Use before large enrichment/search runs to understand current API usage and plan/budget constraints. If experiencing 403s on credit/usage sensitive endpoints, use this tool to confirm whether the key has master privileges (this endpoint will 403 without a master key).

Frequently asked questions

What can I automate with Apollo on Definable?

Anything Apollo exposes through its API. Common crm workflows on Definable include enrich new leads, route deals by ICP, flag stalled opportunities. Personas can call any of the 48 Apollo tools directly, then chain the result into another integration without you writing code.

How does Apollo authentication work?

Apollo uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Apollo integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 48 Apollo tools. You only need a separate Apollo subscription if Apollo itself charges per seat or per API call.

Is using Apollo through Definable secure?

Every call from a persona to Apollo is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Apollo on Definable?

Sign up for Definable, open the integrations page, find Apollo, and connect via OAuth or API key. You can immediately attach Apollo to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Apollo actions does Definable expose?

Definable exposes all 48 Apollo actions as callable tools — including `Add Contacts to Sequence`, `Bulk organization enrichment`, `Bulk people enrichment`, plus 45 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Apollo?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations