Apollo.io

Read and write Apollo contacts, accounts, deals and tasks, enrol contacts in sequences, and run credit-metered enrichment.

Keep prospecting data in Apollo aligned with the CRM, and enrich records from Apollo's database where credits allow.

Build a flow with Apollo.io Provider API documentation

Source actions

Destination actions

Data types

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

account stages

List account stages
Source
List account stages configured for the team.

accounts

Create account
Destination
Not retried automatically
Creates an account. Apollo does not deduplicate accounts on create.
Get account
Source
One account by Apollo ID.
Search accounts
Source
Accounts saved in the team's Apollo account.
Update account
Destination
Duplicate protected
Updates the mapped account fields.

calls

Search calls
Source
Call records logged in Apollo, optionally within a date range.

contact stages

List contact stages
Source
List contact stages configured for the team.

contacts

Create contact
Destination
Not retried automatically
Creates a contact. Without deduplication Apollo always creates a new contact.
Get contact
Source
One contact by Apollo ID.
Search contacts
Source
Contacts saved in the team's Apollo account; filter by keywords, stage or list.
Update contact
Destination
Duplicate protected
Updates the mapped contact fields. label_names replaces existing lists.
Create or match contact
Destination
Duplicate protected
Creates a contact, or returns the existing matching contact (run_dedupe).

deal stages

List deal stages
Source
List deal stages configured for the team.

deals

Create deal
Destination
Not retried automatically
Creates a deal.
Get deal
Source
One deal by Apollo ID.
List deals
Source
All deals (opportunities) in the team's Apollo account.
Update deal
Destination
Duplicate protected
Updates the mapped deal fields, for example to move its stage.

fields

List fields
Source
Standard and custom fields with their Apollo types, for mapping typed_custom_fields.

notes

List notes
Source
Notes for a contact, account or deal.

organizations

Enrich organization
Destination
Not retried automatically
Returns enriched company data for one domain. Consumes one Apollo credit per organization.

people

Enrich person
Destination
Not retried automatically
Matches one person in Apollo's database and returns enriched profile data. Consumes Apollo credits per match.
Search Apollo people database
Source
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 contacts

Add contact to sequence
Destination
Not retried automatically
Enrols one contact in a sequence. Apollo then sends the sequence's emails, so enable this only for explicit enrolment flows.

sequences

Search sequences
Source
Sequences in the team's Apollo account. Requires a master API key.

tasks

Create task
Destination
Not retried automatically
Creates a task for a user to act on a contact.
Search tasks
Source
Tasks in the team's Apollo account. Requires a master API key.
Update task
Destination
Duplicate protected
Updates a scheduled task (owner, contact, type, priority, due date, title or note).

users

List users
Source
Users in the Apollo team. Requires a master API key.

Authentication

Apollo API key (x-api-key header)

Plans and access

API access depends on the Apollo plan; enrichment consumes plan credits. Some endpoints (people search, users, sequences) 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.

Provider events

Apollo does not offer general record-change webhooks for this API. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

people.enrich and organizations.enrich consume Apollo credits; they are billable and never retried automatically.
people.enrich sends the identifying fields as query parameters, as Apollo documents; phone reveal (which requires a webhook) is not offered.
Contact search returns 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.
Contact and record creation have no idempotency key except contacts.upsert, which uses Apollo's run_dedupe.
Apollo has no last-modified filter on contact or account search; sort by updated date instead.