# Search Accounts — Apollo

> 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…

- Key: `apollo_io_oauth-search-accounts`
- Type: Action (Read-only)
- Version: 0.0.2
- App: Apollo (`apollo_io_oauth`) — https://pipedream.com/apps/apollo-io-oauth.md
- This page (HTML): https://pipedream.com/apps/apollo-io-oauth/actions/search-accounts
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/apollo_io_oauth/actions/search-accounts/search-accounts.mjs

## Description

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](https://docs.apollo.io/reference/search-for-accounts)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `query` | `string` | No | Search by account/organization name. Example: "Acme Corp". |
| `accountStageIds` | `string[]` | No | Filter by one or more account stage IDs. Use List Metadata (type account_stages) to discover valid stage IDs. |
| `sortByField` | `string` | No | The field to sort results by. |
| `sortAscending` | `boolean` | No | Set to true for ascending order, false for descending. Defaults to descending. |
| `maxResults` | `integer` | No | Maximum number of accounts to return. Defaults to 100. Max 600. |

## Run it

**MCP**

```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()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "apollo_io_oauth-search-accounts",
  arguments: {
    query: "Query",
    accountStageIds: ["Account Stage IDs"],
  },
})
```

**TypeScript**

```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-search-accounts",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    apollo_io_oauth: { authProvisionId: "apn_xxxxxxx" },
    query: "Query",
    accountStageIds: ["Account Stage IDs"],
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "apollo_io_oauth-search-accounts",
    "configured_props": {
      "apollo_io_oauth": { "authProvisionId": "apn_xxxxxxx" },
      "query": "Query",
      "accountStageIds": ["Account Stage IDs"]
    }
  }'
```

---

- App: https://pipedream.com/apps/apollo-io-oauth.md · All apps: https://pipedream.com/apps