> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your app to Apollo.io

> Connect your app to Apollo.io to search its B2B database of people and companies, enrich contact and organization data, and manage contacts, accounts, and deals from your Lovable app.

export const connector_0 = "Apollo.io"

[Apollo.io](https://www.apollo.io/) is a B2B sales intelligence and engagement platform with a database of people and companies. The Apollo.io connector lets your Lovable app search that database, enrich contacts and organizations, and manage contacts, accounts, and deals.

With Apollo.io, your app can:

* 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

It's a good fit for prospecting dashboards, lead-enrichment forms, and internal sales tools built on live Apollo 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.**<br />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.**<br />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.**<br />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.**<br />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.**<br />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.**<br />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](/integrations/introduction#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](/integrations/introduction#who-can-create-connections))

<Note>
  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.
</Note>

### 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:

<Steps>
  <Step title="Open your Apollo.io account">
    Sign in to [Apollo.io](https://app.apollo.io/).
  </Step>

  <Step title="Open API settings">
    Go to [Settings → Integrations → API Keys](https://app.apollo.io/#/settings/integrations/api).
  </Step>

  <Step title="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>

  <Step title="Copy the key">
    Copy the key and store it securely. You'll paste it into Lovable in the next step.
  </Step>
</Steps>

<Warning>
  Your API key functions like a password. Keep it secure and never share it publicly.
</Warning>

See the [Apollo API documentation](https://docs.apollo.io/) for details.

### Step 2: Connect Apollo.io to Lovable

You can create multiple connections using different API keys.

<Steps>
  <Step title="Open Apollo.io in Connectors">
    Go to **Connectors → App connectors** and select **Apollo.io**.
  </Step>

  <Step title="Add a connection">
    Click **Add connection**.
  </Step>

  <Step title="Configure the connection">
    1. **Display name**: name the connection, for example `Apollo.io Prod`. This name is only used inside Lovable to identify the connection.
    2. **API key**: paste your Apollo.io API key.
  </Step>

  <Step title="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.

    See [Who can manage connections](/integrations/introduction#who-can-manage-connections) for more information.
  </Step>

  <Step title="Connect">
    Click **Connect**. Lovable validates the key against Apollo before saving the connection.
  </Step>
</Steps>

When connected, anyone building in a project can ask Lovable in chat to link their project to Apollo.io (based on configured connection-level access). Your Lovable apps can then search, enrich, and manage Apollo data through Lovable's connector gateway.

## 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 with `error_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](/integrations/introduction#gateway-based-connectors); 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

If an API key is revoked or deleted in Apollo, reconnect the integration in Lovable with a valid key before API calls can succeed again.

## How to unlink projects from a {connector_0} 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:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to manage.
  </Step>

  <Step title="Select projects">
    Under **Linked projects**, check the projects you want to unlink.
  </Step>

  <Step title="Confirm">
    Click **Unlink projects** and confirm.
  </Step>
</Steps>

When unlinked, those projects will no longer have access to {connector_0} through this connection. If a project needs {connector_0} again, you can link it to any available connection.

## How to delete a {connector_0} connection

Workspace admins and owners can delete {connector_0} connections. Other members can delete a connection if they created it, or if they have been explicitly granted access to it.

<Warning>
  Deleting a connection is permanent and cannot be undone. It will remove the credentials from all linked projects, and any apps using this connection will stop working until a new connection is added.
</Warning>

Before deleting, review the **Linked projects** section to see which projects are currently using the connection.

To delete a connection:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to remove.
  </Step>

  <Step title="Review linked projects">
    Review the **Linked projects** section.
  </Step>

  <Step title="Delete">
    Under **Delete this connection**, click **Delete** and confirm.
  </Step>
</Steps>