Skip to main content

​
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.
Connect Apollo.io to Ana to query and analyze your prospecting and engagement data using natural language.

​
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 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. Go to app.textql.com.
  2. On the bottom left sidebar click Connectors → APIs and check that Apollo.io appears in your list of active connectors.
  3. Open a new Ana chat and ask a simple query, such as: “List my Apollo contact lists.”
    • If Ana returns results, the connection is working. If you see an error, refer to Section 6: Troubleshooting.

​
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

SymptomLikely CauseFix
Test fails with 401Invalid, revoked, or incorrectly copied API keyCreate a new key under Settings → Integrations → API Keys and update the connector in TextQL.
Test fails despite a valid keyThe 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 onlyThe key is scoped to a subset of endpoints, or the endpoint requires a master keyAdd the missing endpoints to the key, or recreate it as a master key.
API access denied entirelyYour Apollo plan does not include API accessUpgrade your Apollo plan or contact Apollo sales.
429 errorsApollo rate limits exceededApollo 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.

​
Need Help?

For further assistance, please contact support@textql.com.

​
Privacy Policy

For information about how we handle your data and protect your privacy, please review our Privacy Policy.