Apollo
API integration

list_all_apollo_users

List the users (teammates) in your Apollo account, with their IDs, names, titles and emails. Use the IDs as owner or user IDs in other calls. Requires a master API key; a normal key gets 403. Paginate with page and per_page.

get_single_apollo_user_by_id

Get one Apollo user (teammate) by user ID, including name, title and email. Use users.list to find user IDs. Required: id.

list_all_apollo_organization_enrichment

Enrich one company by its domain and return its Apollo organization record: industry, employee count, revenue, location, LinkedIn URL and technologies. Uses 1 enrichment credit per match. Required: domain.

list_all_apollo_email_accounts

List the email accounts (mailboxes) linked to your Apollo team, with their IDs, owner user IDs and status. Use an email account ID as send_email_from_email_account_id when adding contacts to a sequence. Requires a master API key.

apollo_people_enrichment_match

Find one person by email, LinkedIn URL, or a name (name, or first_name and last_name) together with the company they work at (organization_name or domain), and return their enriched profile. Costs 1-9 credits when a person is matched (more if a mobile phone is revealed), 0 credits on no match. Every parameter is sent as a query-string parameter, even though the HTTP method is POST -- Apollo's own OpenAPI spec marks every one of them `in: query`, and no JSON body is sent. Phone numbers cannot be revealed through this integration: reveal_phone_number triggers an asynchronous webhook/poll flow that is not offered here.

apollo_people_enrichment_bulk_match

Bulk people enrichment. Endpoint essentials API key access api/v1/people/bulk_match or Master API key OAuth scopes people_bulk_match Free account access Requires an Apollo account registered with a work email address. Required: details.

apollo_organizations_enrich

Find one company by domain, LinkedIn URL, or website (name alone is not accepted -- Apollo returns 422 -- but it narrows the match when sent alongside another identifier), and return its enriched profile. 1 credit per organization matched. Every parameter is sent as a query-string parameter; no JSON body is sent. This is a separate method from the pre-existing organization-enrichment.list (added before unified enrichment existed): that method's `list` resource-method type makes the engine apply the integration's inherited page-format pagination unconditionally, adding `page`/`per_page` query parameters this endpoint does not document; this `enrich` method is a custom-named method, so no pagination logic runs and no undocumented parameters are added.

apollo_organizations_bulk_enrich

Bulk organization enrichment. Enrichment is when you refresh existing records so your prospecting data is up-to-date. Use the bulk organization enrichment endpoint to enrich data for up to ten companies with a single API call. Credits: 1 credit per organization. Needs an API key with api/v1/organizations/bulk_enrich access, or a master key.

get_single_apollo_organization_by_id

Get complete organization info. Organizations are companies you haven't yet saved as accounts on Apollo. Use the get complete organization info endpoint to retrieve complete details about an organization in Apollo. Credits: 1 credit per company. Needs an API key with api/v1/organizations/show access, or a master key. Required: id.

list_all_apollo_mixed_people

Search for people. 0 credits. Requires a master API key, or a key with the mixed_people_api_search OAuth scope -- a normal API key gets a 403 "endpoint access denied". Results are partial: there is no email or phone field at all in this search response (only boolean has_email/has_direct_phone flags), and the last name is masked (last_name_obfuscated, e.g. "Hu***n") rather than withheld outright, so every record from this method is partial. Every filter and the page/per_page pagination parameters are sent as query-string parameters, even though the HTTP method is POST.

list_all_apollo_mixed_companies

Search for companies. 1 credit per page (unlike the people-search sibling, this is not free). Records here are full, not masked. Every filter and the page/per_page pagination parameters are sent as query-string parameters, even though the HTTP method is POST.

list_all_apollo_contacts

Search the contacts saved in your team's Apollo account. Free (0 credits). `q_keywords` matches names, job titles, employers and email addresses (partial matches included); it does not match LinkedIn URLs. Apollo shows at most 50,000 records per search (100 per page, 500 pages).

get_single_apollo_contact_by_id

Get one contact saved in your team's Apollo account by its Apollo contact ID. Free (0 credits).

create_a_apollo_contact

Create a contact in your team's Apollo account. Free (0 credits). Apollo does not deduplicate by default; with `run_dedupe: true` it matches an existing contact (by id, CRM ids, the linked Apollo person (for example via `linkedin_url`), email, or name plus company) and updates it in place instead. Custom field values go in `typed_custom_fields`, keyed by the bare custom field ID (without the `contact.` prefix).

update_a_apollo_contact_by_id

Update a contact in your team's Apollo account. Free (0 credits). Only the fields you send change; an empty value clears a field. Custom field values go in `typed_custom_fields`, keyed by the bare custom field ID.

apollo_contacts_bulk_create

Create up to 100 contacts in one request. Free (0 credits). With `run_dedupe: true`, contacts Apollo already has are returned unchanged in `existing_contacts` instead of being duplicated.

apollo_contacts_bulk_update

Update up to 1,000 contacts in one request (more than 100 are processed asynchronously). Free (0 credits).

apollo_contacts_bulk_update_stages

Update contact stage for multiple contacts. Contact stages help you track progress on sales and marketing pipelines. Use the update contact stage for multiple contacts endpoint to update the contact stage for several contacts in your team's Apollo account. Credits: 0 credits. Needs an API key with api/v1/contacts/update_stages access, or a master key. Required: contact_ids, contact_stage_id.

apollo_contacts_bulk_update_owners

Update contact owner for multiple contacts. Contact owners manage specific contacts in Apollo. Use the update contact owner for multiple contacts endpoint to assign multiple contacts to a different user in your team's Apollo account. Credits: 0 credits. Needs an API key with api/v1/contacts/update_owners access, or a master key. Required: contact_ids, owner_id.

list_all_apollo_accounts

Search the accounts (companies) saved in your team's Apollo account. Free (0 credits). `q_organization_name` matches account names only, never domains. Apollo shows at most 50,000 records per search (100 per page, 500 pages).

get_single_apollo_account_by_id

Get one account saved in your team's Apollo account by its Apollo account ID. Free (0 credits).

create_a_apollo_account

Create an account (company) in your team's Apollo account. Free (0 credits). Apollo never deduplicates on this endpoint; use bulk_create with `run_dedupe: true` to reuse an existing account. Custom field values go in `typed_custom_fields`, keyed by the bare custom field ID (without the `account.` prefix).

update_a_apollo_account_by_id

Update an account in your team's Apollo account. Free (0 credits). Only the fields you send change. Custom field values go in `typed_custom_fields`, keyed by the bare custom field ID.

apollo_accounts_bulk_create

Create up to 100 accounts in one request. Free (0 credits). With `run_dedupe: true`, Apollo matches existing accounts by domain, Apollo organization ID or name and returns them unchanged in `existing_accounts`.

apollo_accounts_bulk_update

Update up to 1,000 accounts in one request. Free (0 credits).

apollo_accounts_bulk_update_owners

Update account owner for multiple accounts. Account owners manage saved accounts in Apollo. Use the update account owner for multiple accounts endpoint to assign multiple accounts to a different user in your team's Apollo account. Credits: 0 credits. Needs an API key with api/v1/accounts/update_owners access, or a master key. Required: account_ids, owner_id.

list_all_apollo_fields

List the fields in your team's Apollo account (system and custom) for contacts, accounts and deals. Pass `source=custom` for custom fields only. Free (0 credits).

create_a_apollo_field

Create a custom field on contacts, accounts or deals (`modality`). Types: string, textarea, number, date, datetime, boolean. Apollo's API cannot create picklist fields. Free (0 credits).

update_a_apollo_field_by_id

Update one custom field (for example its label). Send it in a `fields` array, identified by its ID in `modality.field_id` format. A field's type and modality cannot change. Free (0 credits).

list_all_apollo_contact_stages

List the contact stages in your team's Apollo account. Use the IDs as `contact_stage_id`. Free (0 credits).

list_all_apollo_account_stages

List the account stages in your team's Apollo account. Use the IDs as `account_stage_id`. Free (0 credits).

list_all_apollo_sequences

Search the sequences in your team's Apollo account. `q_name` matches part of a sequence name. Free (0 credits).

apollo_sequences_add_contacts

Add contacts to a sequence. Pass the sequence ID as `sequence_id` and again as `emailer_campaign_id`, the contacts as `contact_ids[]`, and the sending mailbox as `send_email_from_email_account_id` (required; list mailboxes with email-accounts). Every parameter is a query parameter. By default Apollo skips contacts without a verified email, contacts in other sequences, contacts who recently changed jobs and contacts whose company is already in the sequence; each has a flag to allow it. Skipped contacts come back in `skipped_contact_ids`. Free (0 credits). Contacts start receiving steps only while the sequence is active.

apollo_sequences_remove_contacts

Update contact status in a sequence. Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time. Credits: 0 credits. Needs an API key with api/v1/emailer_campaigns/remove_or_stop_contact_ids access, or a master key. Required: emailer_campaign_ids, contact_ids, mode.

create_a_apollo_sequence

Create a sequence. Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time. Credits: 0 credits. Needs an API key with api/v1/sequences/create access, or a master key.

update_a_apollo_sequence_by_id

Update a sequence. Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time. Use the update a sequence endpoint to update an existing sequence (emailer campaign) in your team's Apollo account. Credits: 0 credits. Needs an API key with api/v1/sequences/update access, or a master key. Required: id.

apollo_sequences_activate

Activate a sequence. Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time. Use the activate a sequence endpoint to start an inactive sequence. Credits: 0 credits. Needs an API key with api/v1/emailer_campaigns/approve access, or a master key. Required: sequence_id.

apollo_sequences_deactivate

Deactivate a sequence. Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time. Use the deactivate a sequence endpoint to stop an active sequence. Credits: 0 credits. Needs an API key with api/v1/emailer_campaigns/abort access, or a master key. Required: sequence_id.

apollo_sequences_archive

Archive a sequence. Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time. Use the archive a sequence endpoint to archive a sequence. Credits: 0 credits. Needs an API key with api/v1/emailer_campaigns/archive access, or a master key. Required: sequence_id.

list_all_apollo_mailboxes

List the mailboxes (linked email accounts) your team uses to send sequence emails. Use an ID as `send_email_from_email_account_id` when adding contacts to a sequence. Free (0 credits).

apollo_assistant_tasks_poll

Poll an Assistant task. Endpoint essentials API key access api/v1/agents/poll_task or Master API key OAuth scopes agent_task Credit usage 0 credits Polling only reads the task, so it never consumes credits. Required: task_id.

create_a_apollo_assistant_task

Run an Assistant task. Endpoint essentials API key access api/v1/agents/task or Master API key OAuth scopes agent_task Credit usage Variable, based on the actions the Assistant performs. Polling consumes 0 credits .

list_all_apollo_organization_job_postings

Organization job postings. This endpoint consumes 1 Apollo credit per page, with up to 10,000 results per page. Learn more about API pricing and credits. Organizations are companies you haven't yet saved as accounts on Apollo. Credits: 1 credit per page. Needs an API key with api/v1/organizations/job_postings access, or a master key. Required: organization_id.

get_single_apollo_contact_duplicate_by_id

Find a potential duplicate contact. Contacts are people saved in Apollo. Use the find a potential duplicate contact endpoint to check whether a contact in your team's Apollo workspace has a likely duplicate. Pass one contact ID in the path. Credits: 0 credits. Needs an API key with api/v1/contacts/find_potential_duplicate access, or a master key. Required: id.

create_a_apollo_contact_merge

[BETA] Merge duplicate contacts. Contacts are people saved in Apollo. Use the merge duplicate contacts endpoint to merge up to 100 groups of duplicate contacts in one request. In each group, the master contact is the one you keep. Credits: 0 credits. Needs an API key with api/v1/duplicate_contacts/merge access, or a master key. Required: contacts.

get_single_apollo_contact_merge_by_id

[BETA] View a contact merge job. Contacts are people saved in Apollo. Use the view a contact merge job endpoint to check the progress of a merge started with the merge duplicate contacts endpoint. Credits: 0 credits. Needs an API key with api/v1/duplicate_contacts/merge_job access, or a master key. Required: id.

list_all_apollo_contact_deals

View associated deals. Deals on Apollo help you track sales opportunities. Use the view associated deals endpoint to retrieve the deals associated with a contact. This endpoint doesn't require a request body. If you include one, Apollo doesn't read its fields. Credits: 0 credits. Needs an API key with deals/api/v1/opportunities/search access, or a master key. Required: contact_id.

list_all_apollo_email_schedules

List email schedules. Sending schedules control the days and times that Apollo sends emails for your sequences. Credits: 0 credits. Needs an API key with api/v1/emailer_schedules/index access, or a master key.

create_a_apollo_deal

Create deal. Deals on Apollo help you track sales opportunities. Use the create deal endpoint to create new deals for an Apollo account. To update existing deals in your Apollo account, use the update deal endpoint instead. Credits: 0 credits. Needs an API key with deals/api/v1/opportunities/create access, or a master key. Required: name.

list_all_apollo_deals

List all deals. Deals on Apollo help you track sales opportunities. Use the list all deals endpoint to retrieve every deal that has been created for your team's Apollo account. Credits: 0 credits. Needs an API key with deals/api/v1/opportunities/search access, or a master key.

get_single_apollo_deal_by_id

View deal. Deals on Apollo help you track sales opportunities. Use the view deal endpoint to retrieve complete details about a deal within your team's Apollo account. Credits: 0 credits. Needs an API key with deals/api/v1/opportunities/show access, or a master key. Required: id.

update_a_apollo_deal_by_id

Update deal. Deals on Apollo help you track sales opportunities. Use the update deal endpoint to update the details of existing deals within your team's Apollo account. To create new deals in your Apollo account, use the create deal endpoint instead. Credits: 0 credits. Needs an API key with deals/api/v1/opportunities/update access, or a master key. Required: id.

list_all_apollo_deal_stages

List deal stages. Deals on Apollo help you track sales opportunities. Use the list deal stages endpoint to retrieve information about every deal stage that's available in your team's Apollo account. Credits: 0 credits. Needs an API key with deals/api/v1/opportunity_stages/index access, or a master key.

create_a_apollo_task

Create a task. Tasks let you track, prioritize, and help you complete actions required for your outbound sales motion. Use the create a task endpoint to create a single task in Apollo for you and your team. Credits: 0 credits. Needs an API key with api/v1/tasks/create access, or a master key. Required: user_id, contact_id, type, status, due_at.

apollo_tasks_bulk_create

Bulk create tasks. Tasks let you track, prioritize, and help you complete actions required for your outbound sales motion. Use the bulk create tasks endpoint to create multiple tasks in a single API request. Credits: 0 credits. Needs an API key with api/v1/tasks/bulk_create access, or a master key. Required: user_id, contact_ids, type, status, due_at.

get_single_apollo_task_by_id

Get a task. Tasks let you track, prioritize, and help you complete actions required for your outbound sales motion. Use the get a task endpoint to retrieve the full details for a single task that belongs to your team's Apollo account. Credits: 0 credits. Needs an API key with api/v1/tasks/show access, or a master key. Required: id.

update_a_apollo_task_by_id

Update a task. Tasks let you track, prioritize, and help you complete actions required for your outbound sales motion. Use the update a task endpoint to change the details of an existing task that belongs to your team's Apollo account. Credits: 0 credits. Needs an API key with api/v1/tasks/update access, or a master key. Required: id.

apollo_tasks_complete

Complete a task. Tasks let you track, prioritize, and help you complete actions required for your outbound sales motion. Use the complete a task endpoint to mark an existing task as completed . Credits: 0 credits. Needs an API key with api/v1/tasks/complete access, or a master key. Required: task_id.

apollo_tasks_skip

Skip a task. Tasks let you track, prioritize, and help you complete actions required for your outbound sales motion. Use the skip a task endpoint to mark an existing task as skipped without completing it. Credits: 0 credits. Needs an API key with api/v1/tasks/skip access, or a master key. Required: task_id.

list_all_apollo_tasks

Search for tasks. Tasks let you track, prioritize, and help you complete actions required for your outbound sales motion. Use the search for tasks endpoint to find tasks that your team has created in Apollo. Credits: 0 credits. Needs an API key with api/v1/tasks/search access, or a master key.

create_a_apollo_email

Create an email draft. Use the create an email draft endpoint to create a single, unsent email message (an email draft) for a contact. The draft is created with a drafted status — this endpoint doesn't send the email. Credits: 0 credits. Needs an API key with api/v1/emailer_messages/create access, or a master key. Required: contact_id.

apollo_emails_send

Send email now. Use the send email now endpoint to immediately send an existing email message.This works for emails that are currently in a drafted , scheduled , or failed state. Credits: 0 credits. Needs an API key with api/v1/emailer_messages/send_now access, or a master key. Required: email_id.

apollo_emails_get_content

Get email content. Use the get email content endpoint to retrieve the subject line, body, and recipients of emails that your team has already sent. Credits: 0 credits. Needs an API key with api/v1/emailer_messages/get_content access, or a master key. Required: ids.

apollo_emails_get_send_status

Check email send status. Use the check email send status endpoint to check the current delivery status of an email message. Credits: 0 credits. Needs an API key with api/v1/emailer_messages/email_send_status access, or a master key. Required: id.

list_all_apollo_emails

Search for outreach emails. Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time. Use the search for outreach emails endpoint to find emails that your team has created and sent as part of Apollo sequences. Credits: 0 credits. Needs an API key with api/v1/emailer_messages/search access, or a master key.

list_all_apollo_me

Get current user profile. Users are the people who use your Apollo workspace. Use the get current user profile endpoint to retrieve the authenticated profile of the person who owns the API key being used. By default, the endpoint returns the user's identity fields. Credits: 0 credits. Needs an API key with api/v1/users/api_profile access, or a master key.

list_all_apollo_lists

Get a list of all lists. Use the get a list of all lists endpoint to retrieve information about every list that has been created in your Apollo account. This endpoint can be used to check the available lists before you use the create a contact endpoint. Credits: 0 credits. Needs an API key with api/v1/labels/index access, or a master key.

create_a_apollo_list

Create a list. A list is a saved group of contacts or accounts in Apollo that you can organize, action, and track together. Use the create a list endpoint to create a new, empty contact or account list in your team's Apollo account. Credits: 0 credits. Needs an API key with api/v1/labels/create access, or a master key. Required: name, modality.

update_a_apollo_list_by_id

Update a list. A list is a saved group of contacts or accounts in Apollo that you can organize, action, and track together. Use the update a list endpoint to rename an existing list or to toggle its Book of Business status. Credits: 0 credits. Needs an API key with api/v1/labels/update access, or a master key. Required: id, name.

apollo_lists_add_records

Add records to a list. A list is a saved group of contacts or accounts in Apollo that you can organize, action, and track together. Use the add records to a list endpoint to add existing contacts or accounts to one or more lists, referencing the lists by name. Credits: 0 credits. Needs an API key with api/v1/labels/add_entity_ids_to_label_names access, or a master key. Required: entity_ids, label_names, modality.

apollo_lists_remove_records

Remove records from a list. A list is a saved group of contacts or accounts in Apollo that you can organize, action, and track together. Use the remove records from a list endpoint to remove contacts or accounts from one or more lists, referencing the lists by name. Credits: 0 credits. Needs an API key with api/v1/labels/remove_entity_ids_from_label_names access, or a master key. Required: entity_ids, label_names, modality.

list_all_apollo_custom_fields

Get a list of all custom fields. This endpoint is deprecated. To achieve the same result, use the fields endpoint (use source: custom to get custom fields only). Credits: 0 credits. Needs an API key with api/v1/typed_custom_fields/index access, or a master key.

get_single_apollo_person_by_id

Get complete person info. Use the get complete person info endpoint to retrieve complete details about a person in the Apollo database, including employment history, location, and the full details of the person's current organization. Credits: 1 credit per person. Needs an API key with api/v1/people/show access, or a master key. Required: id.

list_all_apollo_calls

Search for calls. Use the search for calls endpoint to find calls that your team has made or received using the dialer on Apollo. Credits: 0 credits. Needs an API key with Master API key access, or a master key.

create_a_apollo_call

Create call records. Use the create call records endpoint to log calls in Apollo that were made using outside systems such as Orum or Nooks. This endpoint can only be used create call records, not to dial prospects. Credits: 0 credits. Needs an API key with Master API key access, or a master key.

update_a_apollo_call_by_id

Update call records. Use the update call records endpoint to update your team's call records in Apollo. Credits: 0 credits. Needs an API key with Master API key access, or a master key. Required: id.

list_all_apollo_email_activities

Check email stats. Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time. Use the check email stats endpoint to review the complete details for an email sent as part of an Apollo sequence. Credits: 0 credits. Needs an API key with Master API key access, or a master key. Required: email_id.

get_single_apollo_webhook_result_by_id

Poll webhook result. Use the poll webhook result endpoint to retrieve webhook results from Apollo. This endpoint enables you to poll for the webhook payload if you didn't receive the original webhook callback. Credits: 0 credits. Needs an API key with api/v1/webhook_result/show access, or a master key. Required: id.

list_all_apollo_credit_usage_stats

View credit usage stats. Use the view credit usage stats endpoint to monitor your team's credit balance across every credit type in the current billing cycle. Credits: 0 credits. Needs an API key with api/v1/usage_stats/credit_usage_stats access, or a master key.

list_all_apollo_api_usage_stats

View API usage stats and rate limits. Use the view API usage stats endpoint to view your team's usage of Apollo API and your rate limit for API endpoints. Each endpoint has a rate limit per minute, hour, and day. Your Apollo plan does impact the rate limits for API endpoints. Credits: 0 credits. Needs an API key with api/v1/usage_stats/api_usage_stats access, or a master key.

list_all_apollo_news_articles

News articles search. This endpoint consumes 1 Apollo credit per page, with up to 25 results per page. Learn more about API pricing and credits. News includes articles related to companies in Apollo. Credits: 1 credit per page. Needs an API key with api/v1/news_articles/search access, or a master key. Required: organization_ids.

list_all_apollo_sequence_activity

Get contact sequence activity. Sequences are outreach campaigns that sales teams use to reach out to contacts over a planned period of time. Credits: 0 credits. Needs an API key with api/v1/emailer_campaigns/activity_feed access, or a master key. Pass the contact to look up (e.g. contact_id) in the body; Apollo returns 404 when it is missing or unknown. Required: contact_id.

list_all_apollo_notes

Get a list of notes. Notes on Apollo let you keep track of info directly on prospect profiles. The get a list of notes endpoint retrieves notes associated with a specific contact, account, opportunity, calendar event, or conversation in your Apollo account. Credits: 0 credits. Needs an API key with meetings/api/v1/notes/index access, or a master key. Apollo requires at least one filter, e.g. contact_id, account_id or opportunity_id.

apollo_analytics_reports_search

Query analytics report. Use the query analytics report endpoint to programmatically query Apollo analytics and retrieve aggregated sales activity data for your team. Credits: 0 credits. Needs an API key with api/v1/reports/sync_report access, or a master key. Required: metrics, group_by, sorts, filters, group_by_totals_selected, pivot_group_by_totals_selected, date_ranges.

list_all_apollo_conversations

Search conversations. Conversations are prospect video meetings stored in Apollo. Use the search conversations endpoint to find a list of conversations. Credits: 0 credits. Needs an API key with api/v1/conversations/search access, or a master key.

get_single_apollo_conversation_by_id

Get conversations info. This endpoint consumes 1 Apollo credit per conversation if the conversation has AI insights. Conversations without AI insights consume 0 credits. Learn more about API pricing and credits. Credits: 0–1 credit per conversation. Needs an API key with api/v1/conversations/show access, or a master key. Required: id.

create_a_apollo_conversation_export

Export conversations. This endpoint consumes 1 Apollo credit per conversation if the conversation has AI insights. Conversations without AI insights consume 0 credits. Learn more about API pricing and credits. Credits: 0–1 credit per conversation. Needs an API key with api/v1/conversations/export access, or a master key. Required: start_time, end_time, email.

get_single_apollo_conversation_export_by_id

Get conversations export. Conversations are prospect video meetings stored in Apollo. Use the get conversations export endpoint to retrieve a download URL for your exported conversations. This endpoint is used as a follow-up to the export conversations endpoint. Credits: 0 credits. Needs an API key with api/v1/conversations/find_export access, or a master key. Required: id.