CONNECT APP
Build with Apollo (API Key)
CRM
- API key
MCP
Give your agent Apollo (API Key) tools
Every Apollo (API Key) action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Apollo (API Key) account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{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",
},
},
},
)
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-add-contacts-to-sequence",
arguments: {
sequenceId: "Sequence ID",
contactIds: ["Contact IDs"],
},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{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",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Add Contacts to Sequence:
result = await session.call_tool("apollo_io-add-contacts-to-sequence", {
"sequenceId": "Sequence ID",
"contactIds": ["Contact IDs"],
})API PROXY
Call the Apollo (API Key) API directly
For an endpoint with no pre-built tool, the Connect proxy forwards your request to the Apollo (API Key) API with the connected user's credentials attached. You store no tokens and write no refresh logic.
const resp = await pd.proxy.get({
externalUserId: "{external_user_id}", // any stable ID for this user in your system
accountId: "apn_xxxxxxx",
url: "https://api.apollo.io/v1/auth/health",
})
// Any allowed Apollo (API Key) endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.# The path segment is the target URL, URL-safe base64 encoded:
# https://api.apollo.io/v1/auth/health
curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuYXBvbGxvLmlvL3YxL2F1dGgvaGVhbHRo?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
-H "Authorization: Bearer {access_token}" \
-H "x-pd-environment: production"SDK
Run Apollo (API Key) actions from your backend
Connect a user's Apollo (API Key) account once, then run Add Contacts to Sequence on their behalf from your own code — TypeScript, Python, or plain HTTP.
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-add-contacts-to-sequence",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
apollo_io: { authProvisionId: "apn_xxxxxxx" },
sequenceId: "Sequence ID",
contactIds: ["Contact IDs"],
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="apollo_io-add-contacts-to-sequence",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"apollo_io": {"authProvisionId": "apn_xxxxxxx"},
"sequenceId": "Sequence ID",
"contactIds": ["Contact IDs"],
},
)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-add-contacts-to-sequence",
"configured_props": {
"apollo_io": { "authProvisionId": "apn_xxxxxxx" },
"sequenceId": "Sequence ID",
"contactIds": ["Contact IDs"]
}
}'TOOLS
Apollo (API Key) actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Add Contacts to Sequence
actionAdds one or more contacts to a sequence in Apollo.io. See the documentationWritev0.0.8 -
Create Account
actionCreates a new account in Apollo.io. See the documentationWritev0.0.8 -
Create Contact
actionCreates a new contact in Apollo.io. See the documentationWritev0.0.9 -
Create Opportunity
actionCreates a new opportunity in Apollo.io. See the documentationWritev0.0.7 -
Create Or Update Contact
actionCreates or updates a specific contact. If the contact email already exists, it's updated. Otherwise, a new contact is created. See the documentationWritev0.0.6 -
Get Opportunity
actionGets a specific opportunity in Apollo.io. See the documentationRead-onlyv0.0.7 -
Get Organization
actionFetch a single organization from Apollo by its ID. Requires a master API key. Use Search For Organizations to discover IDs. See the documentationRead-onlyv0.0.2 -
List Account ID Options
actionRetrieves available options for the Account ID field.Read-onlyv0.0.1 -
List Contact ID Options
actionRetrieves available options for the Contact ID field.Read-onlyv0.0.1 -
List Email Account ID Options
actionRetrieves available options for the Email Account ID field.Read-onlyv0.0.2 -
List Label Names Options
actionRetrieves available options for the Label Names field.Read-onlyv0.0.2 -
List Opportunity ID Options
actionRetrieves available options for the Opportunity ID field.Read-onlyv0.0.1 -
List Opportunity Stage ID Options
actionRetrieves available options for the Opportunity Stage ID field.Read-onlyv0.0.2 -
List Organization Job Postings
actionList the open job postings for a specific Apollo organization. Use Search For Organizations to find a valid organization ID. See the documentationRead-onlyv0.0.2 -
List Owner ID Options
actionRetrieves available options for the Owner ID field.Read-onlyv0.0.2 -
People Enrichment
actionEnriches a person's information, the more information you pass in, the more likely we can find a match. See the documentationWritev0.0.10 -
People Search
actionFind people in the Apollo database using filters such as titles, seniorities, locations, technologies, and employer attributes. Requires a master API key. Use Search For Organizations first to find Apollo organization IDs you want to filter by. See the documentationRead-onlyv0.0.2 -
Search For Accounts
actionSearch for accounts in Apollo.io. See the documentationRead-onlyv0.0.8 -
Search For Contacts
actionSearch for contacts in Apollo.io. See the documentationRead-onlyv0.0.8 -
Search For Organizations
actionSearch the Apollo database for companies (organizations) using filters such as name, domain, employee count, location, technologies, revenue, funding, and job postings. See the documentationRead-onlyv0.0.2 -
Search For Sequences
actionSearch for sequences in Apollo.io. See the documentationRead-onlyv0.0.8 -
Search News Articles
actionSearch for news articles related to one or more Apollo organizations. Use Search For Organizations to find organization IDs first. See the documentationRead-onlyv0.0.2 -
Update Account
actionUpdates an existing account in Apollo.io. See the documentationWritev0.0.8 -
Update Account Stage
actionUpdates the stage of one or more accounts in Apollo.io. See the documentationWritev0.0.8 -
Update Contact
actionUpdates an existing contact in Apollo.io. See the documentationWritev0.0.9 -
Update Contact Stage
actionUpdates the stage of one or more contacts in Apollo.io. See the documentationWritev0.0.8 -
Update Opportunity
actionUpdates a new opportunity in Apollo.io. See the documentationWritev0.0.7
EVENTS
Apollo (API Key) triggers
Event sources your backend can deploy for users and receive through a webhook.
-
Account Updated
triggerEmit new event when an account is updated. See the documentationv0.0.7 -
Contact Updated
triggerEmit new event when a contact is updated. See the documentationv0.0.9 -
New Account Created
triggerEmit new event when an account is created. See the documentationv0.0.7 -
New Contact Created
triggerEmit new event when a contact is created. See the documentationv0.0.9
MULTI-APP
Use Apollo (API Key) with other popular apps
Most products don't stop at one integration. Pair Apollo (API Key) with the other apps your users rely on, and ship use cases that span both.
REFERENCE
App details
Reference metadata for the Apollo (API Key) connector in the Pipedream registry.
- App slug
- apollo_io
- Authentication
- API key
- Categories
- CRM
- Actions
- 27
- Triggers
- 4
- API proxy
- Available