- UseBuildFeaturesTRIGGERSStart background agents from events across your connected appsFIREWALLNEWBlocks instructions hidden in tool results before your agent reads themINSTANTNEWAudio, video, search, browser and data tools, with no keys to manageOPTIMIZATIONLower cost per completed task with optimised tools and skills
- DOCS
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.SIGN UP
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.LOG IN
Apollo API
Give your agents access to Apollo API. Bring your own Apollo key, or skip the signup and pay per call from your Composio balance with Composio Instant.
Apollo is a CRM and lead generation platform that helps businesses discover contacts and manage sales pipelines. Use it to streamline customer outreach and track your deals from one place.
What is Composio Instant?
Composio Instant lets your agent use paid APIs like Apollo without a separate account or API key for each one. New accounts start with $2 of free credit.
No Apollo account or key
Your agent calls Apollo through Composio, so there is nothing to sign up for, store, or rotate.
Pay per call, at cost
Estimated $0.02 per organization enriched, paid from your Composio balance with zero markup.
Works in any agent
Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.
Works with your apps
Use Apollo with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.
Connect the Apollo API to your AI assistant
Use Apollo from the AI assistant you already work in. Connect Composio once, then paste the prompt.
- 1Install in ChatGPT
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks. - 2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection. - 3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio. - 4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.
- 1Install in Cursor
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser. - 2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.
- 1Add to Grok Bot
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add. - 2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize. - 3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.
- 1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.Set up Composio from composio.dev/hermes - 2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection. - 3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.
ClaudeNew chatPaste this prompt
Use Apollo through Composio Instant to enrich company data for microsoft.com. Return a brief summary of the company details Apollo provides.
What success looks like
APOLLO_ORGANIZATION_ENRICHMENTYour assistant runs Apollo and replies with a summary of the company details for Microsoft.
Use the Apollo API in your code
Call Apollo from your own agent with the Composio SDK. Four steps and one tool call.
- 1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.export COMPOSIO_API_KEY="your_composio_api_key" - 2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.pip install composionpm install @composio/core - 3APOLLO_ORGANIZATION_ENRICHMENT
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account. - 4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.
import { Composio } from "@composio/core";
const composio = new Composio();
const session = await composio.create("user_123", {
toolkits: ["apollo"],
instant: {
toolkits: { enable: ["apollo"] },
returnInstantCharge: true,
},
});
const result = await session.execute(
"APOLLO_ORGANIZATION_ENRICHMENT",
{
"domain": "microsoft.com"
},
{ account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);{
"data": "<organization details>",
"error": "<error value>",
"successful": "<successful value>",
"instant_charge": {
"amount": "<usd amount>",
"currency": "USD",
"charged_by": "<provider>"
}
}Available Apollo API tools
9 Apollo tools run on Instant, priced per call with no Apollo key. Tools marked Your key need your own Apollo account.
| Action | Tool slug | What it does | Availability |
|---|---|---|---|
| Search People | APOLLO_PEOPLE_SEARCH | Find net-new prospects in Apollo using search filters. | Instant$0 per request |
| Search Organizations | APOLLO_ORGANIZATION_SEARCH | Search Apollo's organization database with filters and paginated results. | InstantEstimated $0.02 per organization search page |
| Enrich Organization | APOLLO_ORGANIZATION_ENRICHMENT | Retrieve company details using its domain. | InstantEstimated $0.02 per organization enriched |
| Enrich Person | APOLLO_PEOPLE_ENRICHMENT | Enrich a person profile using an Apollo ID or other supported identifiers. | Instant$0.02–$0.18 per person enriched; waterfall may cost more. |
| Search Company News | APOLLO_SEARCH_NEWS_ARTICLES | Find news articles about companies in Apollo's database. | InstantEstimated $0.02 per news-result page |
| Bulk organization enrichment | APOLLO_BULK_ORGANIZATION_ENRICHMENT | Enriches data for up to 10 organizations simultaneously by providing a list of their base company domains (e.g., 'apollo.io', not 'www.apollo.io'). | InstantEstimated $0.02 per organization enriched in the batch |
| Bulk people enrichment | APOLLO_BULK_PEOPLE_ENRICHMENT | Enriches up to 10 person profiles from Apollo's database; charges may apply per person enriched, and unmatched entries may be null. | Instant$0.02–$0.18 per person enriched; waterfall may cost more. |
| Get Organization by ID | APOLLO_GET_ORGANIZATION | Retrieves organization information by Apollo ID, including available funding, technology, and employee data. | InstantEstimated $0.02 per organization retrieved |
| Get Organization Job Postings | APOLLO_GET_ORGANIZATION_JOB_POSTINGS | Retrieves paginated job postings for a specified organization by its ID, optionally filtering by domain; ensure organization_id is a valid identifier. | InstantEstimated $0.02 per job-posting result page |
| Search Contacts | APOLLO_SEARCH_CONTACTS | Find contacts in your Apollo database by keyword or stage. | Your key |
| Create Sequence | APOLLO_CREATE_SEQUENCE | Create an Apollo outreach sequence with optional steps and email variants. | Your key |
| Add Contacts | APOLLO_ADD_CONTACTS_TO_SEQUENCE | Add contacts to a specified Apollo email sequence. | Your key |
Instant prices are Apollo's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.
Apollo API use cases and example prompts
Copy a prompt into your agent. Each one uses Apollo with apps you connect through Composio.
Build a logistics prospect list
Use Apollo to find heads of IT at logistics companies. Add the results to my Logistics Prospects sheet in Google Sheets, then post the sheet link in Slack's #sales channel with a brief summary of the list.
Apps used: Apollo, Google Sheets, Slack
Prepare an account research brief
Use Apollo to find the Acme company record and recent news about Acme. Add the company details and relevant news links to the Acme company record in HubSpot, then draft a Gmail message for my account team with the key points.
Apps used: Apollo, HubSpot, Gmail
Find IT leaders for outreach
Use Apollo to find IT leaders at logistics companies for my regional sales team. Add the prospects to my Logistics Outreach sheet in Google Sheets so the team can review the list.
Apps used: Apollo, Google Sheets
Track company news for sales
Use Apollo to find news about the companies in my account watchlist. Add a page to my Sales Research space in Notion with the company names, article titles, and links, then share the page in Slack's #sales channel.
Apps used: Apollo, Notion, Slack
Apollo API troubleshooting
Still stuck? The Instant tools docs cover limits, charges and session settings.
Set q_organization_domains to the bare company domain, without www. or @, in APOLLO_PEOPLE_SEARCH.
Set reveal_phone_number to true and provide a publicly accessible webhook_url in APOLLO_PEOPLE_ENRICHMENT.
Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.
Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Apollo account.
Check credential_source and instant_charge in the Composio execution log.
Other tools on Instant
These tools also run on Composio Instant and use the same Composio balance.
Clay
Clay is a go-to-market data enrichment and workflow automation platform for searching people and companies, running routines, and querying workspace tables. It helps teams enrich leads, automate GTM workflows, and keep workspace data synchronized.
Firecrawl
Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.
Tavily
Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.
Exa
Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.
Start with Apollo.It takes 30 seconds.
Managed auth, hosted MCP servers, and every Apollo tool your agent needs.Free to start.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.Start building