# Apollo — Pipedream Connect

> The leading AI Sales Platform

- API slug: `apollo_io_oauth` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: CRM
- Website: https://www.apollo.io
- Managed OAuth scopes: `read_user_profile` · `app_scopes` · `people_match` · `person_read` · `opportunity_write` · `opportunity_read` · `opportunity_update` · `contact_write` · `contact_update` · `contacts_search` · `contact_stages_list` · `account_write` · `account_update` · `accounts_search` · `account_stages_list` · `emailer_campaigns_search` · `emailer_campaigns_add_contact_ids` · `users_list` · `email_accounts_list` · `opportunity_stages_list`
- This page (HTML): https://pipedream.com/apps/apollo-io-oauth
- Tools: 10 actions · 0 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: apollo_io_oauth`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "apollo_io_oauth",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Contacts to Sequence:
const result = await mcp.callTool({
  name: "apollo_io_oauth-add-contacts-to-sequence",
  arguments: {
    sequenceId: "Sequence ID",
    contactIds: ["Contact IDs"],
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Apollo endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://app.apollo.io/api/v1/users/api_profile

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcHAuYXBvbGxvLmlvL2FwaS92MS91c2Vycy9hcGlfcHJvZmlsZQ?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "apollo_io_oauth-add-contacts-to-sequence",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    apollo_io_oauth: { authProvisionId: "apn_xxxxxxx" },
    sequenceId: "Sequence ID",
    contactIds: ["Contact IDs"],
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (10)

### `apollo_io_oauth-add-contacts-to-sequence` — Add Contacts to Sequence (Write)

Adds one or more contacts to an email outreach sequence in Apollo. Requires a sequence ID, contact IDs, and a sending email account ID. Use List Metadata (type sequences) to find sequence IDs, (type email_accounts) to find email account IDs. Use Search Contacts to find contact IDs to enroll. Set…

Full schema: https://pipedream.com/apps/apollo-io-oauth/actions/add-contacts-to-sequence.md

### `apollo_io_oauth-create-or-update-account` — Create or Update Account (Write)

Creates a new account (company) or updates an existing one in your Apollo CRM. To create, omit accountId and provide at least a name. To update, provide the accountId and any fields to change. Use Search Accounts to find existing accounts before updating. Use List Metadata (type account_stages) to…

Full schema: https://pipedream.com/apps/apollo-io-oauth/actions/create-or-update-account.md

### `apollo_io_oauth-create-or-update-contact` — Create or Update Contact (Write)

Creates a new contact or updates an existing one in your Apollo CRM. To create, omit contactId and provide at least an email. To update, provide the contactId and any fields to change. Use Search Contacts to find existing contacts by name or email before updating. Use List Metadata (type…

Full schema: https://pipedream.com/apps/apollo-io-oauth/actions/create-or-update-contact.md

### `apollo_io_oauth-create-or-update-opportunity` — Create or Update Opportunity (Write)

Creates a new opportunity (deal) or updates an existing one in your Apollo CRM. To create, omit opportunityId and provide name, opportunityStageId, closedDate, and accountId. To update, provide the opportunityId and any fields to change. Use Get Opportunity to fetch current details before updating…

Full schema: https://pipedream.com/apps/apollo-io-oauth/actions/create-or-update-opportunity.md

### `apollo_io_oauth-enrich-person` — Enrich Person (Write)

Enriches a person's information using Apollo's 270M+ contact database. Pass any combination of name, email, domain, organization, or LinkedIn URL — the more info you provide, the better the match. This action consumes Apollo enrichment credits. Returns detailed profile data including title…

Full schema: https://pipedream.com/apps/apollo-io-oauth/actions/enrich-person.md

### `apollo_io_oauth-get-current-user` — Get Current User (Read-only)

Returns the authenticated user's profile including their ID, name, email, and team information. Use this tool first to identify the current user's ID for filtering records by owner in Search Contacts or Search Accounts. See the documentation

Full schema: https://pipedream.com/apps/apollo-io-oauth/actions/get-current-user.md

### `apollo_io_oauth-get-opportunity` — Get Opportunity (Read-only)

Fetches a single opportunity (deal) by ID with full details including name, amount, stage, close date, owner, and linked account. Use Create or Update Opportunity to modify it after retrieval. See the documentation

Full schema: https://pipedream.com/apps/apollo-io-oauth/actions/get-opportunity.md

### `apollo_io_oauth-list-metadata` — List Metadata (Read-only)

Lists metadata such as stages, sequences, labels, email accounts, or team users. Use this tool to discover valid IDs before calling write tools — e.g., find a contact stage ID for Create or Update Contact, a sequence ID for Add Contacts to Sequence, or an opportunity stage ID for Create or Update…

Full schema: https://pipedream.com/apps/apollo-io-oauth/actions/list-metadata.md

### `apollo_io_oauth-search-accounts` — Search Accounts (Read-only)

Searches for accounts (companies) in your Apollo CRM by name, stage, or sort criteria. Returns account name, domain, industry, and stage. Use this to find accounts before updating them with Create or Update Account or linking them to contacts or opportunities. See the documentation

Full schema: https://pipedream.com/apps/apollo-io-oauth/actions/search-accounts.md

### `apollo_io_oauth-search-contacts` — Search Contacts (Read-only)

Searches for contacts in your Apollo CRM by keyword, stage, or sort criteria. Returns contact name, email, title, company, and stage. Use this to find contacts before updating them with Create or Update Contact or enrolling them with Add Contacts to Sequence. The query parameter searches across…

Full schema: https://pipedream.com/apps/apollo-io-oauth/actions/search-contacts.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt