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

# Apollo.io Connector

> Query your Apollo contacts, accounts, sequences, and engagement data directly in Ana.

### **1. Overview**

The Ana x Apollo.io integration connects your Apollo workspace to Ana, giving you natural language access to your sales intelligence data — contacts, accounts, lists, sequences, deals, and engagement activity. Once configured, Ana can search your saved contacts, break down pipeline by account or stage, and analyze outreach performance without leaving your workflow.

<Note>
  Connect Apollo.io to Ana to query and analyze your prospecting and engagement data using natural language.
</Note>

### **2. Prerequisites**

You'll need:

* An Apollo.io account on a plan that includes API access (API access depends on your Apollo plan — check your tier or contact Apollo sales)
* A TextQL account with permission to add API connectors

### **3. Capabilities**

Once configured, Ana can:

* Search and summarize your saved contacts and accounts.
* Break down deals and opportunities by stage, owner, or account.
* Analyze sequence engagement: who's been contacted, replied, or bounced.
* Query your lists and labels to slice prospect data the way your team organizes it.
* Enrich questions about people and organizations with Apollo's data.

### **4. Setup Instructions**

***

### Step 1: Create your Apollo API key

1. Go to [app.apollo.io](https://app.apollo.io) and sign in.
2. Navigate to **Settings → Integrations → API Keys**.
3. Click **Create new key**.
4. Enter a name (e.g. `TextQL`) and a description.
5. Select the API endpoints the key should access:
   * At minimum, include the **Lists/Labels** endpoint (required for the connection test), plus the endpoints for the data you want Ana to query (Contacts, Accounts, Deals, Sequences, etc.).
   * Or toggle **Set as master key** to grant all endpoints — note that some endpoints (e.g. listing users) are master-key-only.
6. Copy the API key immediately and store it securely — this is your only opportunity to see it in full.

### **Step 2: Add Apollo as an API connector in TextQL**

1. Go to app.textql.com and sign in.
2. In the bottom left sidebar, click **Connectors > APIs** and select Apollo.io.
3. In the configuration panel, fill in the fields:
   * Name (e.g. `Apollo`)
   * API Key: paste the key copied from Step 1
4. Click **Test** to verify the key, then click **Save**.

### **Step 3: Verify the connection**

1. Click on the Apollo connector and select Test Connection at the bottom of the panel.

* A successful setup will return Connection successful (200).
* If the test fails, refer to the [Troubleshooting](#6-troubleshooting) section for next steps.

***

### **5. Usage Examples**

Once configured, you can ask Ana:

* "How many contacts do we have saved in Apollo by list?"
* "Which deals are in negotiation, and who owns them?"
* "Show me reply rates for our active sequences this month."
* "Which accounts have we engaged in the last 30 days?"
* "Break down our saved contacts by title or seniority."

### **6. Troubleshooting**

| **Symptom**                      | **Likely Cause**                                                                                     | **Fix**                                                                                           |
| -------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Test fails with 401              | Invalid, revoked, or incorrectly copied API key                                                      | Create a new key under **Settings → Integrations → API Keys** and update the connector in TextQL. |
| Test fails despite a valid key   | The key's endpoint permissions exclude **Lists/Labels** (the connection test calls `/api/v1/labels`) | Edit the key to include the Lists/Labels endpoint, or use a master key.                           |
| 401/403 on specific queries only | The key is scoped to a subset of endpoints, or the endpoint requires a master key                    | Add the missing endpoints to the key, or recreate it as a master key.                             |
| API access denied entirely       | Your Apollo plan does not include API access                                                         | Upgrade your Apollo plan or contact Apollo sales.                                                 |
| 429 errors                       | Apollo rate limits exceeded                                                                          | Apollo enforces per-minute/hour/day limits by plan; retry later or reduce query frequency.        |

### **7. Security Notes**

* Follow the principle of least privilege: scope the key to only the endpoints Ana needs rather than using a master key.
* Anyone with the key can act on your Apollo account within its granted endpoints. Store it securely and never share it in email, chat, or tickets.
* Keys are shown in full only once at creation; rotate the key if you suspect exposure.
* If you no longer need the integration, delete the key in Apollo and remove the connector from TextQL.
* For more details, refer to [Apollo's API documentation](https://docs.apollo.io/docs/authentication).

***

### **Need Help?**

For further assistance, please contact [support@textql.com](mailto:support@textql.com).

### **Privacy Policy**

For information about how we handle your data and protect your privacy, please review our [Privacy Policy](https://textql.com/privacy).