Apollo.io
Keep Apollo.io up to date with every customer, deal and order, without copy and paste.
33 ways to read, 24 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with Apollo.io, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Create account
accounts.createApproval by rule - Log call record
calls.createApproval by rule - List account stages
account_stages.listRead
Example flow
- Apollo.io · List account stages
account_stages.listDone - Apollo.io · Create account
accounts.createMaker-checker - Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches Apollo.io.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to Apollo.io
- Apollo.io's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Read and write Apollo contacts, accounts, deals, tasks, lists, calls and sequences, read outreach activity, and run credit-metered search and enrichment.
Apollo.io API docs- Source actions
- 33
- Destination actions
- 24
- Data types
- 30
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
account stages1
- List account stagesSource
List account stages configured for the team.
accounts5
- Create accountDestinationNot retried automaticallyApproval before production
Creates an account. Apollo does not deduplicate accounts on create.
- Get accountSource
One account by Apollo ID.
- Search accountsSource
Accounts saved in the team's Apollo account.
- Update accountDestinationProvider duplicate protectionApproval before production
Updates the mapped account fields.
- Create or match accountDestinationProvider duplicate protectionApproval before production
Creates an account, or returns the existing account Apollo matches on CRM ID, domain, organization or name (run_dedupe).
calls3
- Log call recordDestinationNot retried automaticallyApproval before production
Logs a call made in another dialer (for example Orum or Nooks). It records the call; it does not dial.
- Search callsSourceIncremental
Call records logged in Apollo, optionally within a date range.
- Update call recordDestinationProvider duplicate protectionApproval before production
Updates a logged call record, for example its outcome, duration or note.
contact deals1
- List a contact's dealsSource
Deals associated with one contact.
contact stages1
- List contact stagesSource
List contact stages configured for the team.
contacts5
- Create contactDestinationNot retried automaticallyApproval before production
Creates a contact. Without deduplication Apollo always creates a new contact.
- Get contactSource
One contact by Apollo ID.
- Search contactsSource
Contacts saved in the team's Apollo account; filter by keywords, stage or list.
- Update contactDestinationProvider duplicate protectionApproval before production
Updates the mapped contact fields. label_names replaces existing lists.
- Create or update contactDestinationProvider duplicate protectionApproval before production
Creates a contact, or updates the existing contact Apollo matches on ID, CRM ID, email or name and company (run_dedupe).
conversations2
- Get conversationSource
One conversation with participants and deals. Consumes one credit when it has AI insights.
- Search conversationsSource
Recorded calls and video meetings, filtered by type, account, contact or date.
deal stages1
- List deal stagesSource
List deal stages configured for the team.
deals4
- Create dealDestinationNot retried automaticallyApproval before production
Creates a deal.
- Get dealSource
One deal by Apollo ID.
- List dealsSource
All deals (opportunities) in the team's Apollo account.
- Update dealDestinationProvider duplicate protectionApproval before production
Updates the mapped deal fields, for example to move its stage.
email accounts1
- List email accountsSource
Mailboxes linked by the team; their IDs are needed to add contacts to a sequence.
email activities1
- Get email statsSource
Activity for one outreach email: the message with its opens, clicks and replies. Requires a master API key.
email drafts1
- Create email draftDestinationNot retried automaticallyApproval before production
Creates one unsent email draft for a contact, or a reply draft to an existing email. Nexra never sends it.
email schedules1
- List email sending schedulesSource
Sending schedules (days, hours and time zone) available to sequences.
emails1
- Search outreach emailsSourceIncremental
Emails created and sent through Apollo sequences, with delivery status and reply sentiment.
fields3
- Create custom fieldDestinationNot retried automaticallyApproval before production
Creates a custom contact, account or deal field.
- List fieldsSource
Standard and custom fields with their Apollo types, for mapping typed_custom_fields.
- Update custom fieldDestinationProvider duplicate protectionApproval before production
Renames a custom field or changes its maximum length or picklist options. Type and record type cannot change.
job postings1
- List organization job postingsSource
Active job postings for one company. Consumes one credit per page.
list memberships1
- Add record to listsDestinationProvider duplicate protectionApproval before production
Adds one contact or account to one or more lists by name. Lists that do not exist are created.
lists3
- Create listDestinationProvider duplicate protectionApproval before production
Creates an empty contact or account list. Names are unique per modality.
- List listsSource
Contact, account and sequence lists (labels) in the team's Apollo account.
- Update listDestinationProvider duplicate protectionApproval before production
Renames a list or changes its Book of Business flag.
me1
- Get current userSource
The Apollo user whose API key the connection uses. Consumes no credits.
news articles1
- Search company newsSource
News articles about one company, optionally by category and publish date. Consumes one credit per page.
notes1
- List notesSource
Notes for a contact, account or deal.
organizations3
- Enrich organizationDestinationNot retried automaticallyApproval before production
Returns enriched company data for one domain. Consumes one Apollo credit per organization.
- Get complete organization infoSource
Full company profile from Apollo's database by organization ID. Consumes one credit.
- Search Apollo company databaseSource
Searches Apollo's company database by name, domain, location, headcount or keywords. Consumes one credit per page.
people3
- Enrich personDestinationNot retried automaticallyApproval before production
Matches one person in Apollo's database and returns enriched profile data. Consumes Apollo credits per match.
- Get complete person infoSource
Full person profile from Apollo's database by person ID. Consumes one credit.
- Search Apollo people databaseSource
Searches Apollo's people database by title, location and employer. Does not reveal emails or phone numbers and does not consume credits. Requires a master API key.
sequence activity1
- Get contact sequence activitySource
One contact's sequence timeline: added, paused, resumed, finished or removed events.
sequence contacts1
- Add contact to sequenceDestinationNot retried automaticallyApproval before production
Enrols one contact in a sequence. Apollo then sends the sequence's emails, so enable this only for explicit enrolment flows.
sequences3
- Create sequence (inactive)DestinationNot retried automaticallyApproval before production
Creates a sequence with optional steps. Nexra always creates it inactive; a user activates it in Apollo.
- Search sequencesSource
Sequences in the team's Apollo account. Requires a master API key.
- Update sequence settingsDestinationProvider duplicate protectionApproval before production
Renames a sequence or changes its schedule, lists and sending limits. Steps and active state are not changed.
task completions1
- Complete taskDestinationProvider duplicate protectionApproval before production
Marks a scheduled task as completed, with an optional completion note.
tasks4
- Create taskDestinationNot retried automaticallyApproval before production
Creates a task for a user to act on a contact.
- Get taskSource
One task with its contact, account and call or email details.
- Search tasksSource
Tasks in the team's Apollo account. Requires a master API key.
- Update taskDestinationProvider duplicate protectionApproval before production
Updates a scheduled task (owner, contact, type, priority, due date, title or note).
usage stats1
- Get API usage and rate limitsSource
Per-endpoint minute, hour and day limits with the requests consumed and left in each window.
users1
- List usersSource
Users in the Apollo team. Requires a master API key.
Access and limits
- Authentication
- Apollo API key (x-api-key header)
- Plans and access
- API access depends on the Apollo plan; enrichment and database search consume plan credits. Some endpoints (people search, users, sequences, calls, email stats) need a master API key. API-key requests act as the workspace's longest-standing admin.
- Test environment
- A free Apollo account can be used to test non-credit endpoints.
- Rate limits
- Per-endpoint minute, hour and day limits by plan (for example 50/200/600 on free plans); HTTP 429 when exceeded. usage_stats.get reports the remaining allowance per endpoint.
- Pagination
- page/per_page with pagination.total_pages; notes use skip/limit; outreach email search pages until a short page.
- Provider events
- Apollo does not offer general record-change webhooks for this API. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- people.generate, organizations.generate, organizations.search, organizations.get, people.get, job_postings.list, news_articles.search and conversations.get consume Apollo credits; they are billable and never retried automatically.
- Contact, account, call and outreach email searches return at most 50,000 records (100 per page, 500 pages).
- Adding contacts to a sequence enrols one contact per operation; Apollo then sends sequence emails on its own schedule. Nexra creates sequences inactive and never activates them.
- Contact and record creation have no idempotency key except contacts.upsert and accounts.upsert, which use Apollo's run_dedupe matching.
- accounts.upsert returns an existing matching account without changing it; use accounts.update to change it.
- Apollo has no last-modified filter on contact or account search; sort by updated date instead. Notes can be filtered by creation date only.
- Email drafts are created unsent; Nexra does not offer Apollo's send-now endpoint.
- fields.update replaces the full picklist when picklist values are sent; send every option you want to keep.
Developer reference
- Create the Apollo.io credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose Apollo.io, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/apollo and the Connections API.