Apollo
Apps & AutomationapolloApollo is an Agent Skill for apps & automation published in the BuilderIO/agent-native repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Enrich contacts and companies via Apollo.io for prospecting and sales intelligence. Use this skill when the user asks about contact details, company research, or finding decision-makers.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/BuilderIO/agent-native/blob/HEAD/templates/analytics/.builder/skills/apollo/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/apollo, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Apollo.io Integration (Contact & Company Enrichment)
Connection
- Base URL:
https://api.apollo.io - Auth:
x-api-key: $APOLLO_API_KEY - Env vars:
APOLLO_API_KEY - Caching: 10-minute in-memory cache, max 120 entries
Server Lib & API Routes
- File:
server/lib/apollo.ts
Exported Functions
| Function | Description |
|---|---|
searchPeople(params) | Search people by criteria |
enrichPerson(email) | Enrich a contact by email (returns null on failure) |
searchOrganizations(query, params?) | Search companies |
enrichOrganization(domain) | Enrich company by domain (returns null on failure) |
API Routes
| Route | Description |
|---|---|
GET /api/apollo/search | Search contacts/companies |
Script Usage
# Search by email
pnpm action apollo-search [email protected]
# Search by company
pnpm action apollo-search --company=Example Inc
# Search by domain
pnpm action apollo-search --domain=example.com
# Find decision-makers
pnpm action apollo-search --company=Example Inc --title=CTO
# Search by name
pnpm action apollo-search --name="John Smith"
Key Patterns & Gotchas
enrichPersonandenrichOrganizationswallow errors and returnnullon failure (try/catch)- API uses POST for all searches and enrichment — POST responses are cached for 10 minutes
- API endpoints:
/v1/mixed_people/search,/v1/people/match,/v1/mixed_companies/search,/v1/organizations/enrich - Pagination info available via
response.pagination?.total_entries