[Knowledge] Apollo Search People — should warn that endpoint requires paid plan

[lucasygu]

Platform

apollo

Action ID

conn_mod_def::GHFywR1WWo8::kY7bkWNWSrOHkNQgK5ZbWg

Action Name

Search People

What's wrong?

Other

Description

The knowledge for Apollo's "Search People" action documents the endpoint, parameters, and response format, but does not mention that this endpoint requires a paid Apollo plan. On the free plan, the API returns:

{
  "error": "api/v1/mixed_people/search is not accessible with this access token on a free plan. Please upgrade your plan from https://app.apollo.io/.",
  "error_code": "API_INACCESSIBLE"
}

This is a problem because:

1. one add apollo connects successfully and shows the connection as "operational" on the free plan
2. one actions search apollo returns the Search People action as available
3. The knowledge documents it as usable with no prerequisites about plan tier
4. AI agents build flows that validate correctly but fail at runtime with a confusing error

The knowledge should add a prerequisite:

## Prerequisites

- **Requires Apollo paid plan.** The `/api/v1/mixed_people/search` endpoint is not 
  accessible on the free plan. Users on the free plan will receive an 
  `API_INACCESSIBLE` error. Upgrade at https://app.apollo.io/.

This likely applies to other Apollo search endpoints as well (Search Contacts, Search Accounts, Search Tasks, Search Outreach Emails). Each of those actions should also be checked and updated if they have the same restriction.

How we discovered this

Building "LinkedIn Contact Enrichment" and "Sales Call Analysis" workflow templates. Both flows use Apollo Search People as the first step. Both validated correctly but failed at runtime on the free plan. The error message is clear but it should be surfaced before an AI agent builds a flow around it.

Source

• Apollo API pricing: https://www.apollo.io/pricing