@excelium-tech/apollo
v0.3.0
Published
Apollo.io enrichment app for Twenty
Readme
Apollo
Turn a name, email, or domain into a full profile — enrich any Person or Company with Apollo.io in one click.
✨ What you get
- Rich Person fields — headline, seniority, departments, verified email status, personal emails, photo, employment history, and async phone reveal
- Rich Company fields — industry, employees, annual revenue, founded year, keywords, technologies, funding, LinkedIn, location, headcount growth, and NAICS codes
- Run it anywhere — from the command menu, as a workflow step, or straight from AI chat
- Smart matching — finds the right profile from a LinkedIn, email, or domain and only writes confident matches
🔑 Setup
This app is free and consumes your own Apollo.io API credits. Set the APOLLO_API_KEY server variable in Settings → Apps to your Apollo.io API key.
Phone reveal (optional)
Apollo reveals phone numbers asynchronously via a webhook. To enable it, set the APOLLO_PHONE_WEBHOOK_URL server variable (Settings → Apps) to the public URL that resolves to this app's phone webhook route (<public-app-base>/webhook/apollo-phone). When unset, enrichment still runs fully and only the async phone reveal is skipped.
Phone reveal is only requested on single Person enrichment (Enrich Person), where Apollo's batch-level request_id maps to exactly one record. Bulk Enrich People never requests phone reveal, so it cannot cross-assign numbers.
To harden the public webhook, set the APOLLO_WEBHOOK_SECRET server variable. When set, incoming webhook calls must present the matching secret via a ?secret=<value> query param or an x-apollo-webhook-secret header — so append ?secret=<value> to your APOLLO_PHONE_WEBHOOK_URL. When unset, the webhook stays open (backward compatible).
