Skip to content
Try for free
On this page

Integrations

Apollo

Search, enrich, and manage contacts with Apollo.io

Use Apollo.io in Sim to search and enrich people and companies, manage CRM contacts and accounts, add contacts to sequences, and create follow-up tasks. Single-record and bulk enrichment operations are documented below.

Connect an Apollo account with OAuth, or save an API key as an Apollo credential. Existing API-key connections and workflows continue to work. OAuth requires an Apollo administrator or a user with permission to authorize third-party apps. Your Apollo plan, permissions, and credits still apply.

For self-hosting, register a public partner OAuth app in the Apollo developer portal, configure APOLLO_CLIENT_ID and APOLLO_CLIENT_SECRET, and register https://<your-domain>/api/auth/oauth2/callback/apollo as a redirect URL. Enable the scopes listed below. API-key credentials remain available without an OAuth client.

OAuth scopes

Sim requests these scopes when someone connects an Apollo account. For a self-hosted deployment, register your own app with the provider using the settings below. See Integrations and OAuth for setup.

SettingValue
Redirect URI<NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/apollo
Environment variablesAPOLLO_CLIENT_ID, APOLLO_CLIENT_SECRET
ScopeDescription
read_user_profileView your Apollo profile
mixed_people_api_searchSearch Apollo people
people_matchEnrich a person in Apollo
people_bulk_matchEnrich people in bulk in Apollo
mixed_companies_searchSearch Apollo companies
organizations_enrichEnrich an Apollo organization
organizations_bulk_enrichEnrich organizations in bulk in Apollo
contact_writeCreate Apollo contacts
contact_updateUpdate Apollo contacts
contacts_searchSearch Apollo contacts
contacts_bulk_createCreate Apollo contacts in bulk
contacts_bulk_updateUpdate Apollo contacts in bulk
account_writeCreate Apollo accounts
account_updateUpdate Apollo accounts
accounts_searchSearch Apollo accounts
account_bulk_createCreate Apollo accounts in bulk
account_stages_updateUpdate Apollo account stages
opportunity_writeCreate Apollo deals
opportunities_listList Apollo deals
opportunity_readView Apollo deals
opportunity_updateUpdate Apollo deals
emailer_campaigns_searchSearch Apollo sequences
emailer_campaigns_add_contact_idsAdd contacts to Apollo sequences
tasks_createCreate Apollo tasks
tasks_listSearch Apollo tasks
email_accounts_listView Apollo email accounts

Use the block

Search for people and companies, enrich contact data, manage your CRM contacts and accounts, add contacts to sequences, and create tasks.

Actions

Apollo People Search

Search Apollo's database for people using demographic filters

Inputs and outputs

Input

ParameterTypeRequiredDescription
person_titlesarrayNoJob titles to search for (e.g., ["CEO", "VP of Sales"])
include_similar_titlesbooleanNoWhether to return people with job titles similar to person_titles
person_locationsarrayNoLocations to search in (e.g., ["San Francisco, CA", "New York, NY"])
person_senioritiesarrayNoSeniority levels (one of: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern)
organization_idsarrayNoApollo organization IDs to filter by (e.g., ["5e66b6381e05b4008c8331b8"])
organization_namesarrayNoCompany names to search within (legacy filter)
organization_locationsarrayNoHeadquarters locations of the people's current employer (e.g., ['texas', 'tokyo', 'spain'])
q_organization_domains_listarrayNoEmployer domain names (e.g., ["apollo.io", "microsoft.com"]) — up to 1,000, no www. or @
organization_num_employees_rangesarrayNoEmployee count ranges for the person's current employer. Each entry is "min,max" (e.g., ["1,10", "250,500", "10000,20000"])
contact_email_statusarrayNoEmail statuses to filter by: "verified", "unverified", "likely to engage", "unavailable"
q_keywordsstringNoKeywords to search for
pagenumberNoPage number for pagination, default 1 (e.g., 1, 2, 3)
per_pagenumberNoResults per page, default 25, max 100 (e.g., 25, 50, 100)

Output

ParameterTypeDescription
peoplejsonArray of people matching the search criteria
pagenumberCurrent page number
per_pagenumberResults per page
total_entriesnumberTotal matching entries

Apollo People Enrichment

Enrich data for a single person using Apollo

Inputs and outputs

Input

ParameterTypeRequiredDescription
first_namestringNoFirst name of the person
last_namestringNoLast name of the person
namestringNoFull name of the person (alternative to first_name/last_name)
idstringNoApollo ID for the person
hashed_emailstringNoMD5 or SHA-256 hashed email
emailstringNoEmail address of the person
organization_namestringNoCompany name where the person works
domainstringNoCompany domain (e.g., "apollo.io", "acme.com")
linkedin_urlstringNoLinkedIn profile URL
reveal_personal_emailsbooleanNoReveal personal email addresses (uses credits)
reveal_phone_numberbooleanNoReveal phone numbers (uses credits, requires webhook_url)
webhook_urlstringNoWebhook URL for async phone number delivery (required when reveal_phone_number is true)

Output

ParameterTypeDescription
personjsonEnriched person data from Apollo
enrichedbooleanWhether the person was successfully enriched

Apollo Bulk People Enrichment

Enrich data for up to 10 people at once using Apollo

Inputs and outputs

Input

ParameterTypeRequiredDescription
peoplearrayYesArray of people to enrich (max 10)
reveal_personal_emailsbooleanNoReveal personal email addresses (uses credits)
reveal_phone_numberbooleanNoReveal phone numbers (uses credits, requires webhook_url)
webhook_urlstringNoWebhook URL for async phone number delivery (required when reveal_phone_number is true)

Output

ParameterTypeDescription
matchesjsonArray of enriched people (null entries indicate no match)
total_requested_enrichmentsnumberTotal number of records submitted for enrichment
unique_enriched_recordsnumberNumber of records successfully enriched
missing_recordsnumberNumber of records that could not be enriched
credits_consumednumberNumber of Apollo credits consumed by this request

Apollo Organization Search

Search Apollo's database for companies using filters

Inputs and outputs

Input

ParameterTypeRequiredDescription
organization_locationsarrayNoCompany HQ locations (cities, US states, or countries)
organization_not_locationsarrayNoExclude companies whose HQ is in these locations
organization_num_employees_rangesarrayNoEmployee count ranges as "min,max" strings (e.g., ["1,10", "250,500", "10000,20000"])
q_organization_keyword_tagsarrayNoIndustry or keyword tags
q_organization_namestringNoOrganization name to search for (e.g., "Acme", "TechCorp")
organization_idsarrayNoApollo organization IDs to include (e.g., ["5e66b6381e05b4008c8331b8"])
q_organization_domains_listarrayNoDomain names to filter by (no www. or @, up to 1,000)
pagenumberNoPage number for pagination (e.g., 1, 2, 3)
per_pagenumberNoResults per page, max 100 (e.g., 25, 50, 100)

Output

ParameterTypeDescription
organizationsjsonArray of organizations matching the search criteria
pagenumberCurrent page number
per_pagenumberResults per page
total_entriesnumberTotal matching entries

Apollo Organization Enrichment

Enrich data for a single organization using Apollo

Inputs and outputs

Input

ParameterTypeRequiredDescription
domainstringYesCompany domain (e.g., "apollo.io", "acme.com")

Output

ParameterTypeDescription
organizationjsonEnriched organization data from Apollo
enrichedbooleanWhether the organization was successfully enriched

Apollo Bulk Organization Enrichment

Enrich data for up to 10 organizations at once using Apollo

Inputs and outputs

Input

ParameterTypeRequiredDescription
domainsarrayYesArray of company domains to enrich (max 10, no www. or @, e.g., ["apollo.io", "stripe.com"])

Output

ParameterTypeDescription
organizationsjsonArray of enriched organization data
totalnumberTotal number of domains requested
enrichednumberNumber of unique enriched records
missing_recordsnumberNumber of domains that could not be enriched
unique_domainsnumberNumber of unique domains processed

Apollo Create Contact

Create a new contact in your Apollo database

Inputs and outputs

Input

ParameterTypeRequiredDescription
first_namestringYesFirst name of the contact
last_namestringYesLast name of the contact
emailstringNoEmail address of the contact
titlestringNoJob title (e.g., "VP of Sales", "Software Engineer")
account_idstringNoApollo account ID to associate with (e.g., "acc_abc123")
owner_idstringNoUser ID of the contact owner (accepted by Apollo but not officially documented for POST /contacts)
organization_namestringNoName of the contact's employer (e.g., "Apollo")
website_urlstringNoCorporate website URL (e.g., "https://www.apollo.io/")
label_namesarrayNoLists/labels to add the contact to (e.g., ["Prospects"])
contact_stage_idstringNoApollo ID for the contact stage
present_raw_addressstringNoPersonal location for the contact (e.g., "Atlanta, United States")
direct_phonestringNoPrimary phone number
corporate_phonestringNoWork/office phone number
mobile_phonestringNoMobile phone number
home_phonestringNoHome phone number
other_phonestringNoAlternative phone number
typed_custom_fieldsjsonNoCustom field values keyed by custom field ID
run_dedupebooleanNoWhen true, Apollo deduplicates against existing contacts

Output

ParameterTypeDescription
contactjsonCreated contact data from Apollo
createdbooleanWhether the contact was successfully created

Apollo Update Contact

Update an existing contact in your Apollo database

Inputs and outputs

Input

ParameterTypeRequiredDescription
contact_idstringYesID of the contact to update (e.g., "con_abc123")
first_namestringNoFirst name of the contact
last_namestringNoLast name of the contact
emailstringNoEmail address
titlestringNoJob title (e.g., "VP of Sales", "Software Engineer")
account_idstringNoApollo account ID (e.g., "acc_abc123")
owner_idstringNoUser ID of the contact owner (accepted by Apollo but not officially documented for PATCH /contacts/{id})
organization_namestringNoName of the contact's employer (e.g., "Apollo")
website_urlstringNoCorporate website URL (e.g., "https://www.apollo.io/")
label_namesarrayNoLists/labels to add the contact to (e.g., ["Prospects"])
contact_stage_idstringNoApollo ID for the contact stage
present_raw_addressstringNoPersonal location for the contact (e.g., "Atlanta, United States")
direct_phonestringNoPrimary phone number
corporate_phonestringNoWork/office phone number
mobile_phonestringNoMobile phone number
home_phonestringNoHome phone number
other_phonestringNoAlternative phone number
typed_custom_fieldsjsonNoCustom field values keyed by custom field ID

Output

ParameterTypeDescription
contactjsonUpdated contact data from Apollo
updatedbooleanWhether the contact was successfully updated

Apollo Search Contacts

Search your team's contacts in Apollo

Inputs and outputs

Input

ParameterTypeRequiredDescription
q_keywordsstringNoKeywords to search for
contact_stage_idsarrayNoFilter by contact stage IDs
contact_label_idsarrayNoFilter by Apollo label IDs (lists)
sort_by_fieldstringNoSort field: contact_last_activity_date, contact_email_last_opened_at, contact_email_last_clicked_at, contact_created_at, or contact_updated_at
sort_ascendingbooleanNoWhen true, sort ascending. Must be used together with sort_by_field
pagenumberNoPage number for pagination (e.g., 1, 2, 3)
per_pagenumberNoResults per page, max 100 (e.g., 25, 50, 100)

Output

ParameterTypeDescription
contactsjsonArray of contacts matching the search criteria
paginationjsonPagination information

Apollo Bulk Create Contacts

Create up to 100 contacts at once in your Apollo database. Supports deduplication to prevent creating duplicate contacts. Master key required.

Inputs and outputs

Input

ParameterTypeRequiredDescription
contactsarrayYesArray of contacts to create (max 100). Each contact may include first_name, last_name, email, title, organization_name, account_id, owner_id, contact_stage_id, linkedin_url, phone (single string) or phone_numbers (array of {raw_number, position}), contact_emails, typed_custom_fields, and CRM IDs (salesforce_contact_id, hubspot_id, team_id) for cross-system matching
append_label_namesarrayNoLabel names to add to all contacts in this request (e.g., ["Hot Lead"])
run_dedupebooleanNoEnable deduplication to prevent creating duplicate contacts. When true, existing contacts are returned without modification

Output

ParameterTypeDescription
created_contactsjsonArray of newly created contacts
existing_contactsjsonArray of existing contacts (when deduplication is enabled)
total_submittednumberTotal number of contacts submitted
creatednumberNumber of contacts successfully created
existingnumberNumber of existing contacts found

Apollo Bulk Update Contacts

Update up to 100 existing contacts at once in your Apollo database. Each contact must include an id field. Master key required.

Inputs and outputs

Input

ParameterTypeRequiredDescription
contact_idsarrayNoArray of contact IDs to update. Must be paired with an object-form contact_attributes specifying the fields to apply uniformly to all listed contacts.
contact_attributesjsonNoRequired. Either an array of per-contact updates (each with id) — used standalone — or a single object of attributes to apply to all contact_ids. Supported fields: owner_id, email, organization_name, title, first_name, last_name, account_id, present_raw_address, linkedin_url, typed_custom_fields
asyncbooleanNoForce asynchronous processing. Automatically enabled for >100 contacts

Output

ParameterTypeDescription
contactsjsonUpdated contacts (synchronous response, ≤100 contacts)
entity_progress_jobjsonAsync job descriptor (>100 contacts or async=true): {id, status, ...}
job_idstringAsync job ID extracted from entity_progress_job
messagestringOptional confirmation message from Apollo

Apollo Create Account

Create a new account (company) in your Apollo database

Inputs and outputs

Input

ParameterTypeRequiredDescription
namestringYesCompany name (e.g., "Acme Corporation")
domainstringNoCompany domain without www. prefix (e.g., "acme.com")
phonestringNoPrimary phone number for the account
owner_idstringNoApollo user ID of the account owner
account_stage_idstringNoApollo ID for the account stage to assign this account to
raw_addressstringNoCorporate location (e.g., "San Francisco, CA, USA")
typed_custom_fieldsjsonNoCustom field values as { custom_field_id: value } map

Output

ParameterTypeDescription
accountjsonCreated account data from Apollo
createdbooleanWhether the account was successfully created

Apollo Update Account

Update an existing account in your Apollo database

Inputs and outputs

Input

ParameterTypeRequiredDescription
account_idstringYesID of the account to update (e.g., "acc_abc123")
namestringNoCompany name (e.g., "Acme Corporation")
domainstringNoCompany domain (e.g., "acme.com")
phonestringNoCompany phone number
owner_idstringNoApollo user ID of the account owner
account_stage_idstringNoApollo ID for the account stage to assign this account to
raw_addressstringNoCorporate location (e.g., "San Francisco, CA, USA")
typed_custom_fieldsjsonNoCustom field values as { custom_field_id: value } map

Output

ParameterTypeDescription
accountjsonUpdated account data from Apollo
updatedbooleanWhether the account was successfully updated

Apollo Search Accounts

Search your team's accounts in Apollo. Display limit: 50,000 records (100 records per page, 500 pages max). Use filters to narrow results. Master key required.

Inputs and outputs

Input

ParameterTypeRequiredDescription
q_organization_namestringNoFilter accounts by organization name (partial-match search)
account_stage_idsarrayNoFilter by account stage IDs
account_label_idsarrayNoFilter by account label IDs
sort_by_fieldstringNoSort field: "account_last_activity_date", "account_created_at", or "account_updated_at"
sort_ascendingbooleanNoSort ascending when true. Defaults to descending.
pagenumberNoPage number for pagination (e.g., 1, 2, 3)
per_pagenumberNoResults per page, max 100 (e.g., 25, 50, 100)

Output

ParameterTypeDescription
accountsjsonArray of accounts matching the search criteria
paginationjsonPagination information

Apollo Bulk Create Accounts

Create up to 100 accounts at once in your Apollo database. Set run_dedupe=true to deduplicate by domain, organization_id, and name. Master key required.

Inputs and outputs

Input

ParameterTypeRequiredDescription
accountsarrayYesArray of accounts to create (max 100). Each account should include a name, and may optionally include domain, phone, phone_status_cd, raw_address, owner_id, linkedin_url, facebook_url, twitter_url, salesforce_id, and hubspot_id.
append_label_namesarrayNoArray of label names to add to ALL accounts in this request
run_dedupebooleanNoWhen true, performs aggressive deduplication by domain, organization_id, and name (defaults to false)

Output

ParameterTypeDescription
created_accountsjsonArray of newly created accounts
existing_accountsjsonArray of existing accounts returned by Apollo (when duplicates are detected)
failed_accountsjsonArray of accounts that failed to be created, with reasons for failure
total_submittednumberTotal number of accounts in the response (created + existing + failed)
creatednumberNumber of accounts successfully created
existingnumberNumber of existing accounts found
failednumberNumber of accounts that failed to be created

Apollo Bulk Update Accounts

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.

Inputs and outputs

Input

ParameterTypeRequiredDescription
account_idsarrayNoArray of account IDs to update with the same values (max 1000). Use with name/owner_id for uniform updates. Use either this OR account_attributes.
namestringNoWhen using account_ids, apply this name to all accounts
owner_idstringNoWhen using account_ids, apply this owner to all accounts
account_stage_idstringNoWhen using account_ids, apply this account stage to all accounts
account_attributesjsonNoArray of account objects with individual updates (each must include id). Example: [{"id": "acc1", "name": "Acme", "owner_id": "u1", "account_stage_id": "s1", "typed_custom_fields": {"field_id": "value"}}]
asyncbooleanNoWhen true, processes the update asynchronously. Only supported when using account_ids; returns 422 if used with account_attributes.

Output

ParameterTypeDescription
accountsjsonUpdated accounts (synchronous response): [{id, account_stage_id, ...}]
account_idsjsonIDs of accounts that were updated
entity_progress_jobjsonAsync job descriptor (when async=true is passed with account_ids)
job_idstringAsync job ID extracted from entity_progress_job
messagestringOptional confirmation message from Apollo

Apollo Create Opportunity

Create a new deal for an account in your Apollo database (master key required)

Inputs and outputs

Input

ParameterTypeRequiredDescription
namestringYesName of the opportunity/deal (e.g., "Enterprise License - Q1")
account_idstringNoID of the account this opportunity belongs to (e.g., "acc_abc123")
amountstringNoMonetary value as a plain number string with no commas or currency symbols
opportunity_stage_idstringNoID of the opportunity stage
owner_idstringNoUser ID of the opportunity owner
closed_datestringNoExpected close date in YYYY-MM-DD format
typed_custom_fieldsjsonNoCustom field values as { custom_field_id: value } map

Output

ParameterTypeDescription
opportunityjsonCreated opportunity data from Apollo
createdbooleanWhether the opportunity was successfully created

Apollo Search Opportunities

Search and list all deals/opportunities in your team's Apollo account

Inputs and outputs

Input

ParameterTypeRequiredDescription
sort_by_fieldstringNoSort field: "amount", "is_closed", or "is_won"
pagenumberNoPage number for pagination (e.g., 1, 2, 3)
per_pagenumberNoResults per page, max 100 (e.g., 25, 50, 100)

Output

ParameterTypeDescription
opportunitiesjsonArray of opportunities matching the search criteria
pagenumberCurrent page number
per_pagenumberResults per page
total_entriesnumberTotal matching entries

Apollo Get Opportunity

Retrieve complete details of a specific deal/opportunity by ID

Inputs and outputs

Input

ParameterTypeRequiredDescription
opportunity_idstringYesID of the opportunity to retrieve (e.g., "opp_abc123")

Output

ParameterTypeDescription
opportunityjsonComplete opportunity data from Apollo
foundbooleanWhether the opportunity was found

Apollo Update Opportunity

Update an existing deal/opportunity in your Apollo database

Inputs and outputs

Input

ParameterTypeRequiredDescription
opportunity_idstringYesID of the opportunity to update (e.g., "opp_abc123")
namestringNoName of the opportunity/deal (e.g., "Enterprise License - Q1")
amountstringNoMonetary value as a plain number string with no commas or currency symbols
opportunity_stage_idstringNoID of the opportunity stage
owner_idstringNoUser ID of the opportunity owner
closed_datestringNoExpected close date in YYYY-MM-DD format
typed_custom_fieldsjsonNoCustom field values as { custom_field_id: value } map

Output

ParameterTypeDescription
opportunityjsonUpdated opportunity data from Apollo
updatedbooleanWhether the opportunity was successfully updated

Apollo Search Sequences

Search for sequences/campaigns in your team's Apollo account (master key required)

Inputs and outputs

Input

ParameterTypeRequiredDescription
q_namestringNoSearch sequences by name (e.g., "Outbound Q1", "Follow-up")
pagenumberNoPage number for pagination (e.g., 1, 2, 3)
per_pagenumberNoResults per page, max 100 (e.g., 25, 50, 100)

Output

ParameterTypeDescription
sequencesjsonArray of sequences/campaigns matching the search criteria
pagenumberCurrent page number
per_pagenumberResults per page
total_entriesnumberTotal matching entries

Apollo Add Contacts to Sequence

Add contacts to an Apollo sequence

Inputs and outputs

Input

ParameterTypeRequiredDescription
sequence_idstringYesID of the sequence to add contacts to (e.g., "seq_abc123")
contact_idsarrayNoArray of contact IDs to add to the sequence (e.g., ["con_abc123", "con_def456"]). Either contact_ids or label_names must be provided.
label_namesarrayNoArray of label names to identify contacts to add to the sequence. Either contact_ids or label_names must be provided.
send_email_from_email_account_idstringYesID of the email account to send from. Use the Get Email Accounts operation to look this up.
send_email_from_email_addressstringNoSpecific email address to send from within the email account.
sequence_no_emailbooleanNoAdd contacts even if they have no email address
sequence_unverified_emailbooleanNoAdd contacts with unverified email addresses
sequence_job_changebooleanNoAdd contacts who recently changed jobs
sequence_active_in_other_campaignsbooleanNoAdd contacts active in other campaigns
sequence_finished_in_other_campaignsbooleanNoAdd contacts who finished other campaigns
sequence_same_company_in_same_campaignbooleanNoAdd contacts even if others from the same company are in the sequence
contacts_without_ownership_permissionbooleanNoAdd contacts without ownership permission
add_if_in_queuebooleanNoAdd contacts even if they are in the queue
contact_verification_skippedbooleanNoSkip contact verification when adding
user_idstringNoID of the user performing the action
statusstringNoInitial status for added contacts: "active" or "paused"
auto_unpause_atstringNoISO 8601 datetime to automatically unpause contacts

Output

ParameterTypeDescription
addedjsonArray of contact objects successfully added to the sequence
skippedjsonArray of contact objects that were skipped, with reasons
skipped_contact_idsjsonSkipped contact IDs — either an array of IDs or a hash mapping ID → reason code
emailer_campaignjsonDetails of the emailer campaign (id, name)
sequence_idstringID of the sequence contacts were added to
total_addednumberTotal number of contacts added
total_skippednumberTotal number of contacts skipped

Apollo Create Task

Create one or more tasks in Apollo (one task per contact_id, master key required)

Inputs and outputs

Input

ParameterTypeRequiredDescription
user_idstringYesID of the Apollo user the task is assigned to
contact_idsarrayYesArray of contact IDs. One task is created per contact.
prioritystringNoTask priority: "high", "medium", or "low" (defaults to "medium")
due_atstringYesDue date/time in ISO 8601 format (e.g., "2024-12-31T23:59:59Z")
typestringYesTask type: "call", "outreach_manual_email", "linkedin_step_connect", "linkedin_step_message", "linkedin_step_view_profile", "linkedin_step_interact_post", or "action_item"
statusstringYesTask status: "scheduled", "completed", or "skipped"
notestringNoFree-form note providing context for the task

Output

ParameterTypeDescription
tasksjsonArray of created tasks (when returned by Apollo)
createdbooleanWhether the request succeeded

Apollo Search Tasks

Search for tasks in Apollo

Inputs and outputs

Input

ParameterTypeRequiredDescription
sort_by_fieldstringNoSort field: "task_due_at" or "task_priority"
open_factor_namesarrayNoFilter by status. Common values: ["task_types"] for open tasks, ["task_completed_at"] for completed tasks.
pagenumberNoPage number for pagination (e.g., 1, 2, 3)
per_pagenumberNoResults per page, max 100 (e.g., 25, 50, 100)

Output

ParameterTypeDescription
tasksjsonArray of tasks matching the search criteria
paginationjsonPagination information

Apollo Get Email Accounts

Get list of team's linked email accounts in Apollo

Inputs and outputs

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
email_accountsjsonArray of team email accounts linked in Apollo
totalnumberTotal count of email accounts
Was this helpful?
Suggest an edit