- Search Apollo’s B2B database for people and companies
- Enrich contacts and organizations with profile and firmographic data
- Create and manage contacts, accounts, and deals
- Build prospecting and outreach workflows on live sales data
Common use cases and example apps
| Example app | Example prompt | Description |
|---|---|---|
| Company research page | Use Apollo.io and build a company research page that searches Apollo by company name and shows firmographic details. | Turn a company name into a research profile. The app searches Apollo for matching companies and displays their size, industry, and location. |
| Lead enrichment form | Use Apollo.io and build a form where I enter a company domain and get back enriched firmographic data. | Enrich records from a single input. The app calls Apollo’s organization enrichment and fills in company details automatically. |
| Prospecting list builder | Use Apollo.io and build a prospecting tool that searches for people by title and industry and saves them to a list. | Find and shortlist prospects from live data. The app searches Apollo’s people database and lets you save matches for outreach. |
| Contact enrichment on signup | Use Apollo.io and enrich each new signup with their company data when they register. | Add context to new users automatically. The app enriches the signup’s email or domain with Apollo firmographics and stores the result. |
| Sales pipeline dashboard | Use Apollo.io and build a dashboard that creates and tracks accounts and deals from prospect research. | Manage accounts and deals alongside research. The app creates Apollo contacts, accounts, and deals and shows their status in one view. |
| ICP account finder | Use Apollo.io and build a tool that finds companies matching our ideal customer profile by size, industry, and location. | Surface accounts that match your ICP. The app queries Apollo with firmographic filters and lists companies that fit. |
How to connect Apollo.io
Who can create Apollo.io connections depends on your plan and workspace settings. See Who can create connections. You can create multiple Apollo.io connections using different API keys, which is useful for separating environments (for example, development and production) or using different Apollo accounts. When the connection is created, you can link it to the projects where you want to use it. Anyone building in a project can ask Lovable in chat to link their project to it.Prerequisites
Before connecting Apollo.io, make sure you have:- An Apollo.io account
- An Apollo.io API key
- Permission to create connections in your Lovable workspace (see Who can create connections)
All search and enrichment requests through this connector consume Apollo credits and count toward your Apollo plan’s rate limits. Billing and quota are handled directly by Apollo.io, not Lovable.
Step 1: Get an Apollo.io API key
An API key lets your Lovable app authenticate with the Apollo.io API. Apollo scopes each key to the endpoints you grant it, so create the key with access to the endpoints your app needs. To create an Apollo.io API key:Open your Apollo.io account
Sign in to Apollo.io.
Open API settings
Create a key
Click Create new key, give it a descriptive name, for example
Lovable integration, grant access to the API endpoints your app needs, then click Create API key to finish. Some endpoints, such as people search, require a master API key.Step 2: Connect Apollo.io to Lovable
You can create multiple connections using different API keys.Configure the connection
- Display name: name the connection, for example
Apollo.io Prod. This name is only used inside Lovable to identify the connection. - API key: paste your Apollo.io API key.
Choose who can use this connection
Under Who can use this connection, decide who in your workspace can use the connection. You start as the only person with access:
- Only you (default): leave the access list as is; only you can use the connection and its associated data.
- Invite specific people: add workspace members by email; only you and the people you add can use the connection and its associated data.
- Invite entire workspace: click Invite entire workspace to make the connection available to everyone in your Lovable workspace.
Endpoint access and credits
Apollo scopes API keys per endpoint, so a key can call some endpoints and not others. If a request returns a 403 witherror_code: API_INACCESSIBLE, the connected key does not have access to that endpoint. Some endpoints, such as people search, require a master API key. Enable the endpoints your app needs (or use a master key) under Settings → Integrations → API Keys in Apollo, then update the Lovable connection if you created a new key.
Search and enrichment requests consume Apollo credits and count toward Apollo’s per-minute, hourly, and daily rate limits. Cache results and fetch on demand rather than on every page load, so your app stays within Apollo’s quota.
Lovable routes your app’s server-side Apollo calls through its connector gateway; if you edit backend code yourself, call the gateway rather than https://api.apollo.io directly.
Limitations
The Apollo.io connector cannot:- Refresh or rotate API keys automatically. To rotate, create a new key in Apollo and update the Lovable connection
- Support per-end-user Apollo authentication. Each connection represents a single Apollo account shared across all projects linked to it
How to unlink projects from a connection
Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects. To unlink projects:
When unlinked, those projects will no longer have access to through this connection. If a project needs again, you can link it to any available connection.