Apollo.io API integration with managed OAuth. Search and enrich people and companies, manage contacts and accounts. Use this skill when users want to prospect, enrich leads, or manage sales data. For
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Access the Apollo.io API with managed OAuth authentication. Search people and organizations, enrich contacts, and manage your sales pipeline.
# Search for people at a company python <<'EOF' import urllib.request, os, json data = json.dumps({'q_organization_name': 'Google', 'per_page': 10}).encode() req = urllib.request.Request('https://gateway.maton.ai/apollo/v1/mixed_people/api_search', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
https://gateway.maton.ai/apollo/{native-api-path}
Replace
{native-api-path}api.apollo.ioAll requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
Environment Variable: Set your API key as
MATON_API_KEYexport MATON_API_KEY="YOUR_API_KEY"
Manage your Apollo connections at
https://ctrl.maton.aipython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=apollo&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'apollo'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
Response:
{ "connection": { "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80", "status": "ACTIVE", "creation_time": "2025-12-08T07:20:53.488460Z", "last_updated_time": "2026-01-31T20:03:32.593153Z", "url": "https://connect.maton.ai/?session_token=...", "app": "apollo", "metadata": {} } }
Open the returned
urlpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If you have multiple Apollo connections, specify which one to use with the
Maton-Connectionpython <<'EOF' import urllib.request, os, json data = json.dumps({'q_organization_name': 'Google', 'per_page': 10}).encode() req = urllib.request.Request('https://gateway.maton.ai/apollo/v1/mixed_people/api_search', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If omitted, the gateway uses the default (oldest) active connection.
POST /apollo/v1/mixed_people/api_search Content-Type: application/json{ "q_organization_name": "Google", "page": 1, "per_page": 25 }
POST /apollo/v1/people/match Content-Type: application/json{ "email": "john@example.com" }
POST /apollo/v1/people/match Content-Type: application/json{ "linkedin_url": "https://linkedin.com/in/johndoe" }
POST /apollo/v1/organizations/search Content-Type: application/json{ "q_organization_name": "Google", "page": 1, "per_page": 25 }
POST /apollo/v1/organizations/enrich Content-Type: application/json{ "domain": "google.com" }
POST /apollo/v1/contacts/search Content-Type: application/json{ "page": 1, "per_page": 25 }
POST /apollo/v1/contacts Content-Type: application/json{ "first_name": "John", "last_name": "Doe", "email": "john@example.com", "organization_name": "Acme Corp" }
PUT /apollo/v1/contacts/{contactId} Content-Type: application/json{ "first_name": "Jane" }
POST /apollo/v1/accounts/search Content-Type: application/json{ "page": 1, "per_page": 25 }
POST /apollo/v1/accounts Content-Type: application/json{ "name": "Acme Corp", "domain": "acme.com" }
POST /apollo/v1/emailer_campaigns/search Content-Type: application/json{ "page": 1, "per_page": 25 }
POST /apollo/v1/emailer_campaigns/{campaignId}/add_contact_ids Content-Type: application/json{ "contact_ids": ["contact_id_1", "contact_id_2"] }
GET /apollo/v1/labels
Common search parameters:
q_organization_nameq_person_titleperson_locationsorganization_num_employees_rangesq_keywordsconst response = await fetch( 'https://gateway.maton.ai/apollo/v1/mixed_people/api_search', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${process.env.MATON_API_KEY}` }, body: JSON.stringify({ q_organization_name: 'Google', per_page: 10 }) } );
import os import requestsresponse = requests.post( 'https://gateway.maton.ai/apollo/v1/mixed_people/api_search', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}, json={'q_organization_name': 'Google', 'per_page': 10} )
pageper_page/searchpeople/searchmixed_people/searchmixed_people/api_searchcurl -gfields[]sort[]records[]jq$MATON_API_KEY| Status | Meaning |
|---|---|
| 400 | Missing Apollo connection |
| 401 | Invalid or missing Maton API key |
| 429 | Rate limited (10 req/sec per account) |
| 4xx/5xx | Passthrough error from Apollo API |
MATON_API_KEYecho $MATON_API_KEY
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
apollohttps://gateway.maton.ai/apollo/v1/mixed_people/api_searchhttps://gateway.maton.ai/v1/mixed_people/api_searchNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.