Sources

Apollo

Connect an Apollo workspace with one API key and sync its CRM records, outreach emails, calls, users, tasks, sequences, and stages without using enrichment credits.

Connect Apollo as a managed warehouse source with one API key. Embrasure reads records already saved in your Apollo workspace. It does not search Apollo's prospect database or call enrichment endpoints, so ingestion does not spend enrichment credits.

Before you start

You need:

  • An Embrasure workspace administrator
  • An Apollo user who can create an API key
  • An Apollo plan and user role that can read the supported API endpoints

Apollo documents API-key authentication in its API overview.

Connect Apollo

Create a dedicated API key

In Apollo, open SettingsIntegrationsAPI and create an API key for Embrasure warehouse ingestion. Use a dedicated key so it can be rotated or revoked without interrupting another integration.

Open the Apollo source

In Embrasure, open WarehouseIngestion. Select Connect warehouse source for the first source, or New sync if the workspace already has ingestion syncs. Choose Apollo, paste the key, and select Connect.

Verify access

Embrasure checks the Apollo user and workspace identity, then reads one bounded page from each supported resource. The original CRM resources are required. Outreach emails, calls, and users are optional: a permission denial does not prevent connection, and metadata discovery omits those unavailable tables.

Select tables and start the sync

Keep the apollo schema selected, sync metadata, choose the tables you need, and start the batch sync. Each source record keeps useful columns for common analysis and the complete provider response in data.

What is synced

TableContentsHow it updates
apollo.contactsContacts with names, email, title, account, owner, stage, and timestamps.Incremental by Apollo's updated timestamp with a five-minute overlap.
apollo.accountsAccounts with name, domain, website, industry, owner, stage, employee estimate, and timestamps.Incremental by Apollo's updated timestamp with a five-minute overlap.
apollo.opportunitiesOpportunities with amount, outcome, account, owner, stage, and close date.Bounded snapshot rescan.
apollo.tasksTasks with type, status, priority, due time, owner, contact, and account.Bounded snapshot rescan.
apollo.sequencesSequence definitions and status.Bounded snapshot rescan.
apollo.outreach_emailsSequence emails with contact, account, sender, sequence, delivery status, failure reason, and reply class.Bounded snapshot rescan.
apollo.callsApollo dialer calls with contact, account, user, opportunity, outcome and purpose IDs, direction, status, duration in seconds, and start/end times.Snapshot rescan.
apollo.usersWorkspace users with names, email, team, title, and deleted flag. Join id to owner/user IDs in other tables.Snapshot rescan.
apollo.contact_stagesContact stage definitions.Snapshot rescan.
apollo.account_stagesAccount stage definitions.Snapshot rescan.
apollo.opportunity_stagesOpportunity stages, pipeline, probability, and outcome flags.Snapshot rescan.

The new tables use Apollo's outreach email search, call search, and user list endpoints. All three cost zero API credits. Call search requires a master API key; emails and users require their endpoint access or a master key, subject to Apollo plan and role restrictions. After granting access, refresh source metadata to discover newly available tables.

These tables rescan all pages on each sync so changes to older email delivery outcomes, calls, and user details are captured. They expose current state, not event history. Email engagement fields such as replied and bounce, and any other counters or timestamps returned by Apollo, remain queryable in data. Extra fields, including email content when Apollo supplies it, remain in data; ingestion does not make separate content or recording requests.

Apollo caps contacts, accounts, tasks, and outreach email searches at 50,000 matching records. Embrasure reports that limit instead of silently producing an incomplete table. If email search omits totals, a full page at that boundary also fails because completeness cannot be confirmed.

Regular syncs merge current records and do not detect hard deletes. Use Actions → Full resync to replace destination contents from a complete new scan and remove records that no longer appear in Apollo.

Troubleshooting

  • Apollo rejected this API key. Create or copy an active key from the Apollo workspace you want to sync.
  • A supported resource is denied. Confirm the Apollo user, API key, plan, and endpoint access. Verification requires contacts, accounts, opportunities, tasks, sequences, and the three stage endpoints. Optional tables denied during discovery are omitted. If access is revoked after selection, ingestion fails explicitly; grant access or deselect that table.
  • Apollo is rate limiting the connection. Retry shortly. Embrasure respects Apollo's retry response and automatically backs off during ingestion.
  • A table exceeds 50,000 records. Apollo's search endpoint cannot page beyond that boundary. Reduce the source dataset in Apollo before retrying.

Security boundary

Embrasure stores only the API key in encrypted connector credentials. It sends the key in Apollo's x-api-key header and makes read-only requests. The connector does not create or update Apollo records and does not call prospecting or enrichment APIs.